Overview

Create a new address for a customer. The address can be used for shipping physical products or as a billing address.

Example: A customer wants to add their office address for magazine delivery. Create an address with type=shipping and associate it with their subscription.

Conditional Requirements

Condition	Required Fields
Always	`customer_id` OR `customer_old_provider_id`
Always	`type` (`shipping`, `billing`, or `account_primary`)
Always	`line1`, `country`
`country` is `CA`, `US`, or `AU`	`state`
Account has AvaTax address validation enabled AND `country` is `US` or `CA`	`postal_code`
`is_default_updated=true`	Account must NOT have taxes enabled (cannot update subscription addresses when taxes enabled)
Both `customer_id` AND `customer_old_provider_id` are set	Must reference the same customer
Customer is deleted	Request will fail

Related Endpoints

Addresses - Overview of the addresses API