# Create a new customer (https://developer.godaddy.com/en/docs/references/rest/customers/commerce-customers-create)

---
title: Create a new customer
description: >-
  This endpoint can be used to create or de-duplicate - using channel data - and
  merge into existing customer.
full: true
---

Full description

This endpoint can be used to create or de-duplicate - using channel data - and merge into existing customer. If the provided channels differ from existing customer data, a new customer will be created. This endpoint will not remove any existing data and is additive in cases where merges occur.

## POST /stores/{storeId}/customers

Create a new customer

This endpoint can be used to create or de-duplicate - using channel data - and merge into existing customer. If the provided channels differ from existing customer data, a new customer will be created. This endpoint will not remove any existing data and is additive in cases where merges occur.

### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `storeId` | string <uuid> | yes | An identifier for a store |

### Request body (required)

Customer data to import

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/CustomerCreate`

### Responses

**202** — A CUSTOMER_CREATE action was successfully created

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/CustomerActionResponse`

**401** — Authentication info not sent or is invalid

Content-Type: `*/*`

Schema:

- schema reference: `#/components/schemas/Error`

**403** — Authenticated user is not allowed access

Content-Type: `*/*`

Schema:

- schema reference: `#/components/schemas/Error`

**404** — Resource not found

Content-Type: `*/*`

Schema:

- schema reference: `#/components/schemas/Error`

**409** — Application-specific server state error

Content-Type: `*/*`

Schema:

- schema reference: `#/components/schemas/Error`

**422** — Body or query string failed schema validation. Returns the `ValidationError` envelope rather than the generic `Error`.

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ValidationError`

**429** — Too many requests received within interval

Content-Type: `*/*`

Schema:

- schema reference: `#/components/schemas/ErrorLimit`

**500** — Internal server error

Content-Type: `*/*`

Schema:

- schema reference: `#/components/schemas/Error`

**Security:** requires `PAT`; scopes `commerce.customer:create`.