---
title: customerAddressCreate - Customer API
description: Creates a new address for a customer.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/customer/latest/mutations/customerAddressCreate'
  md: >-
    https://shopify.dev/docs/api/customer/latest/mutations/customerAddressCreate.md
api_name: customer
api_type: graphql
type: mutation
---

# customer​Address​Create

mutation

Requires `customer_write_customers` access scope.

Creates a new address for a customer.

## Arguments

* address

  [Customer​Address​Input!](https://shopify.dev/docs/api/customer/latest/input-objects/CustomerAddressInput)

  required

  Specifies the fields to use when creating the address.

* default​Address

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

  Default:false

  The flag to set the address as the default address.

***

## Customer​Address​Create​Payload returns

* customer​Address

  [Customer​Address](https://shopify.dev/docs/api/customer/latest/objects/CustomerAddress)

  The created customer address.

* user​Errors

  [\[User​Errors​Customer​Address​User​Errors!\]!](https://shopify.dev/docs/api/customer/latest/objects/UserErrorsCustomerAddressUserErrors)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### customerAddressCreate reference