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

# customer​Address​Create

mutation

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

## Mutation Reference

```graphql
mutation customerAddressCreate($address: CustomerAddressInput!, $defaultAddress: Boolean) {
  customerAddressCreate(address: $address, defaultAddress: $defaultAddress) {
    customerAddress {
      # CustomerAddress fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

```json
{
  "address": {
    "firstName": "<your-firstName>",
    "lastName": "<your-lastName>",
    "address1": "<your-address1>",
    "address2": "<your-address2>",
    "city": "<your-city>",
    "company": "<your-company>",
    "territoryCode": "<your-territoryCode>",
    "phoneNumber": "<your-phoneNumber>",
    "zoneCode": "<your-zoneCode>",
    "zip": "<your-zip>"
  },
  "defaultAddress": true
}
```