post
https://www.pelcro.com/api/v1/core/addresses
Create a new shipping or billing address for a customer.
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