---
title: customerAddressCreate - Storefront API
description: >-
  Creates a new
  [`MailingAddress`](/docs/api/storefront/2026-10/objects/MailingAddress) for a
  [`Customer`](/docs/api/storefront/2026-10/objects/Customer). Use the
  customer's [access
  token](/docs/api/storefront/2026-10/mutations/customerAddressCreate#arguments-customerAccessToken)

  to identify them. Successful creation returns the new address. 


  Each customer can have multiple addresses.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/latest/mutations/customerAddressCreate
  md: >-
    https://shopify.dev/docs/api/storefront/latest/mutations/customerAddressCreate.md
api_name: storefront
api_type: graphql
type: mutation
---

# customer​Address​Create

mutation

Requires `unauthenticated_write_customers` access scope.

Creates a new [`MailingAddress`](https://shopify.dev/docs/api/storefront/2026-10/objects/MailingAddress) for a [`Customer`](https://shopify.dev/docs/api/storefront/2026-10/objects/Customer). Use the customer's [access token](https://shopify.dev/docs/api/storefront/2026-10/mutations/customerAddressCreate#arguments-customerAccessToken) to identify them. Successful creation returns the new address.

Each customer can have multiple addresses.

## Arguments

* address

  [Mailing​Address​Input!](https://shopify.dev/docs/api/storefront/latest/input-objects/MailingAddressInput)

  required

  The customer mailing address to create.

* customer​Access​Token

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

  required

  The access token used to identify the customer.

***

## Customer​Address​Create​Payload returns

* customer​Address

  [Mailing​Address](https://shopify.dev/docs/api/storefront/latest/objects/MailingAddress)

  The new customer address object.

* customer​User​Errors

  [\[Customer​User​Error!\]!](https://shopify.dev/docs/api/storefront/latest/objects/CustomerUserError)

  non-null

  The list of errors that occurred from executing the mutation.

* user​Errors

  [\[User​Error!\]!](https://shopify.dev/docs/api/storefront/latest/objects/UserError)

  non-nullDeprecated

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### customerAddressCreate reference