Skip to main content
input_object

The input fields to create or update a mailing address.

•String

The first line of the address. Typically the street address or PO Box number.

•String

The second line of the address. Typically the number of the apartment, suite, or unit.

•String

The name of the city, district, village, or town.

•String

The name of the customer's company or organization.

•CountryCode

The two-letter code for the country of the address.

•String

The first name of the customer.

•String

The last name of the customer.

•String

A unique phone number for the customer.

Formatted using E.164 standard. For example, +16135551111.

•String

The code for the region of the address, such as the province, state, or district. For example QC for Quebec, Canada.

•String

The zip or postal code of the address.

Deprecated fields

•StringDeprecated
•IDDeprecated
•StringDeprecated

Was this section helpful?

Anchor to Input objects using this inputInput objects using this input

•INPUT OBJECT

The addresses for a customer.

•INPUT OBJECT

The mailing address associated with the payment method.

•INPUT OBJECT

The mailing address to where the order will be shipped.

•INPUT OBJECT

The mailing address associated with the payment method. This address is an optional field that won't be available on orders that don't require a payment method.


Note

If a customer is provided, this field or shipping_address (which has precedence) will be set as the customer's default address. Additionally, if the provided customer is new or hasn't created an order yet then their name will be set to the first/last name from this address (if provided).


•INPUT OBJECT

The mailing address to where the order will be shipped.


Note

If a customer is provided, this field (which has precedence) or billing_address will be set as the customer's default address. Additionally, if the provided customer doesn't have a first or last name then it will be set to the first/last name from this address (if provided).


•INPUT OBJECT

The new shipping address for the order. Overwrites the existing shipping address.


Was this section helpful?