---
title: CustomerAddressInput - Customer API
description: The input fields to create or update a mailing address.
api_version: 2025-10
api_name: customer
type: input-object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/customer/latest/input-objects/customeraddressinput
  md: https://shopify.dev/docs/api/customer/latest/input-objects/customeraddressinput.md
---

# Customer​Address​Input

input\_object

The input fields to create or update a mailing address.

## Fields

* address1

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

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

* address2

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

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

* city

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

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

* company

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The name of the customer's company or organization.

* first​Name

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The first name of the customer.

* last​Name

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The last name of the customer.

* phone​Number

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The customer's unique phone number, formatted using E.164 standard. For example, *+16135551111*.

* territory​Code

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The country code, in ISO 3166-1 format. Accepts either a two-letter [alpha-2 code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), a three-letter [alpha-3 code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3), or a three-digit [numeric code](https://en.wikipedia.org/wiki/ISO_3166-1_numeric). For example, `US`, `USA`, or `840` represents the United States.

* zip

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The zip or postal code of the address.

* zone​Code

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The alphanumeric code for the region of the address, such as the province, state, or district. For example, 'ON' for Ontario, Canada.

***

## Mutations using this input

* [customer​Address​Create.​address](https://shopify.dev/docs/api/customer/latest/mutations/customerAddressCreate#argument-address)

  MUTATION

* [customer​Address​Update.​address](https://shopify.dev/docs/api/customer/latest/mutations/customerAddressUpdate#argument-address)

  MUTATION

* [subscription​Contract​Fetch​Delivery​Options.​address](https://shopify.dev/docs/api/customer/latest/mutations/subscriptionContractFetchDeliveryOptions#argument-address)

  MUTATION

***

## Input objects using this input

* [Subscription​Delivery​Method​Local​Delivery​Input.​delivery​Address](https://shopify.dev/docs/api/customer/latest/input-objects/SubscriptionDeliveryMethodLocalDeliveryInput#field-deliveryAddress)

  INPUT OBJECT

  The input fields for a local delivery method.

* [Subscription​Delivery​Method​Shipping​Input.​shipping​Address](https://shopify.dev/docs/api/customer/latest/input-objects/SubscriptionDeliveryMethodShippingInput#field-shippingAddress)

  INPUT OBJECT

  The input fields for a shipping delivery method.

***

## Map

### Mutations using this input

* <\~>[customer​Address​Create.address](https://shopify.dev/docs/api/customer/latest/mutations/customerAddressCreate#argument-address)
* <\~>[customer​Address​Update.address](https://shopify.dev/docs/api/customer/latest/mutations/customerAddressUpdate#argument-address)
* <\~>[subscription​Contract​Fetch​Delivery​Options.address](https://shopify.dev/docs/api/customer/latest/mutations/subscriptionContractFetchDeliveryOptions#argument-address)

### Input objects using this input

* [Subscription​Delivery​Method​Local​Delivery​Input.deliveryAddress](https://shopify.dev/docs/api/customer/latest/input-objects/SubscriptionDeliveryMethodLocalDeliveryInput#field-deliveryAddress)
* [Subscription​Delivery​Method​Shipping​Input.shippingAddress](https://shopify.dev/docs/api/customer/latest/input-objects/SubscriptionDeliveryMethodShippingInput#field-shippingAddress)