Skip to main content
Log inSign up

Shopify uses cookies to provide necessary site functionality and improve your experience. By using our website, you agree to our privacy policy and our cookie policy.

input_object

The input fields to create or update a mailing address.

•

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

•

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

•

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

•

The name of the customer's company or organization.

•

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

•

The first name of the customer.

•

The last name of the customer.

•

A unique phone number for the customer.

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

•

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

•

The zip or postal code of the address.

Show
deprecated fields Deprecated
•
StringDeprecated

The name of the country. Use countryCode instead.

•
IDDeprecated

Not needed for 90% of mutations, and provided separately where it is needed.

•
StringDeprecated

The region of the address, such as the province, state, or district. Use provinceCode instead.


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?