---
title: "Create a new customer in eCommerce system.With the exception of the 'id' field, the required fields indicated in the 'Customer' model are those required to create a new customer"
method: POST
path: "/customers"
tags: ["customers"]
---

# Create a new customer in eCommerce system.With the exception of the 'id' field, the required fields indicated in the 'Customer' model are those required to create a new customer

`POST /customers`

## Headers

- `Authorization` string, required

## Request body

- CustomerPost
  - `billingPerson` Person
    - `city` string
    - `companyName` string
    - `countryCode` string
    - `countryName` string
    - `name` string
    - `phone` string
    - `postalCode` string
    - `stateName` string
    - `stateOrProvinceCode` string
    - `stateOrProvinceName` string
    - `street` string
  - `customerGroupId` integer
  - `email` string, required — customer email
  - `password` string — customer password
  - `shippingAddresses` Person[]
    - `city` string
    - `companyName` string
    - `countryCode` string
    - `countryName` string
    - `name` string
    - `phone` string
    - `postalCode` string
    - `stateName` string
    - `stateOrProvinceCode` string
    - `stateOrProvinceName` string
    - `street` string
  - `taxExempt` boolean
  - `taxId` number, double
  - `taxIdValid` boolean

## Response `200`

OK - Everything worked as expected

## Other responses

- `400` — Bad Request - Often due to a missing request parameter
- `401` — Unauthorized - An invalid element token, user secret and/or org secret provided
- `403` — Forbidden - Access to the resource by the provider is forbidden
- `404` — Not found - The requested resource is not found
- `405` — Method not allowed - Incorrect HTTP verb used, e.g., GET used when POST expected
- `406` — Not acceptable - The response content type does not match the 'Accept' header value
- `409` — Conflict - If a resource being created already exists
- `415` — Unsupported media type - The server cannot handle the requested Content-Type
- `500` — Server error - Something went wrong on the Cloud Elements server
- `502` — Provider server error - Something went wrong on the Provider or Endpoint's server

---

[API](https://skmtc.net/cloud-elements/apis/ecwid.md) · [All operations](https://skmtc.net/cloud-elements/apis/ecwid/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloud-elements/ecwid/versions/6c2a6ade2a5b/schema)