Update customer address

Update an existing address with partial data. Only provided fields will be updated.

Partial Updates: This endpoint supports partial updates - only include fields you want to change. Omitted fields will retain their current values.

Default Flag Behavior:

  • Setting is_default_billing: true will unset the flag on all other addresses
  • Setting is_default_shipping: true will unset the flag on all other addresses
  • Only one address can be default billing and one can be default shipping at a time

Duplicate Prevention: If updating address fields would result in a duplicate of another existing address, the update will be rejected with a DUPLICATE_ADDRESS error. This ensures data integrity and prevents confusion in downstream systems.

Validation Status: When address fields are modified, the validation_status may need to be re-verified through tax calculation services.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required
uuid
required
Body Params

Street address line 1 (e.g., building number and street name)

Street address line 2 (e.g., apartment, suite, unit number)

Street address line 3 (additional address information)

City or locality name

State, province, or region

Postal code or ZIP code

Country name (e.g., 'United States')

Two-letter ISO country code (e.g., 'US', 'GB')

Address validation status

connector_validation

Validation data from external connector

Set as default billing address

Set as default shipping address

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json