# Create customer `POST` `https://app.ecwid.com/api/v3/{storeId}/customers`

Request and response example

Request: ```http POST /api/v3/1003/customers HTTP/1.1 Authorization: Bearer secret_token Host: app.ecwid.com Content-Type: application/json Cache-Control: no-cache { "name": "Example customer", "email": "example_customer@example.com", "customerGroupId": 0, "customerGroupName": "General", "billingPerson": { "name": "Support team" }, "taxExempt": false } ``` Response: ```json { "id": 188278629 } ```

### Required access scopes Your app must have the following **access scopes** to make this request: `create_customers` ### Path params All path params are required. | Param | Type | Description | | ------- | ------ | --------------- | | storeId | number | Ecwid store ID. | ### Headers The **Authorization** header is required.

Header	Format	Description
Authorization	`Bearer secret_ab***cd`	Access token of the application.

### Request JSON A JSON object with the following fields:

Field	Type	Description
email	string	Customer's email. Required
password	string	Customer's password for login. Note: only available for stores with the legacy customer sign-in.
billingPerson	object billingPerson	Customer's billing name/address.
shippingAddresses	array of objects shippingAddresses	List of saved shipping addresses for the customer.
contacts	array of objects contacts	Customer's contact information: email, phone, social media links.
customerGroupId	number	ID of the customer group the customer is assigned to.
b2b_b2c	string	Defines business-to-customer relation. One of: `b2c` - Business-to-customer (default) `b2b` - Business-to-business
taxId	string	Customer's tax ID.
taxIdValid	boolean	Defines if customer's tax ID is valid.
taxExempt	boolean	Defines if customer is tax exempt. Requires a valid tax ID. Read more about handling tax exempt customers in Help Center.
acceptMarketing	boolean	Defines if the customer has accepted email marketing. If `true`, you can use customer's email for promotions.
lang	string	Customer's language code. Customers see storefront and emails in this language. This language must be one of the translations enabled in the store.
privateAdminNotes	string	Personal notes about the customer. Visible only to the store owner.

#### billingPerson | Field | Type | Description | | ------------------- | ------ | ----------------------------------------------------- | | name | string | Full name of the customer. | | companyName | string | Customer's company name. | | street | string | Address line 1 and address line 2, separated by `\n`. | | city | string | City. | | countryCode | string | Two-letter country code. | | countryName | string | Country name. | | postalCode | string | Postal/ZIP code. | | stateOrProvinceCode | string | State/province code, for example, `NY`. | | phone | string | Customer's phone number. | #### shippingAddresses | Field | Type | Description | | ------------------- | ------ | ------------------------------------------------------------------------ | | id | number | Internal ID of the saved address. | | name | string | Full name of the customer. | | companyName | string | Customer's company name. | | street | string | Address line 1 and address line 2, separated by `\n`. | | city | string | City. | | countryCode | string | Two-letter country code. | | countryName | string | Country name. | | postalCode | string | Postal/ZIP code. | | stateOrProvinceCode | string | State/province code, for example, `NY`. | | phone | string | Customer's phone number. | | addressFormatted | string | Formatted full address. Includes street, city, state, and country names. | #### contacts

Field	Type	Description
id	number	Internal ID of the customer contact, for example, `113861381`.
contact	string	Email or link to reach the contact. Examples: `ec.apps@lightspeedhq.com` contact for `EMAIL` type. `https://www.facebook.com/myshop_page` contact for `FACEBOOK` type.
handle	string	Contact identifier on social media. For example, for `FACEBOOK` type of contact, it's a page slug: `contact` field: `https://www.facebook.com/myshop_page` `handle` field: `myshop_page`
note	string	Store owner's notes on the contact.
type	string	Contact type. Customer can have several contacts of the same type. One of: `EMAIL`, `PHONE`, `FACEBOOK`, `INSTAGRAM`, `TWITTER`, `YOUTUBE`, `TIKTOK`, `PINTEREST`, `VK`, `FB_MESSENGER`, `WHATSAPP`, `TELEGRAM`, `VIBER`, `URL`, `OTHER`.
default	boolean	Defines if it's a default customer contact. Only one contact of the same type can be default.
orderBy	boolean	Sorting order for contacts on the customer details page. Starts with `0` and increments by `1`.
timestamp	string	Datetime when the customer contact was created.

### Response JSON A JSON object with the following fields: | Field | Type | Description | | ----- | ------ | ------------------------------------ | | id | number | Internal ID of the created customer. | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.ecwid.com/api-reference/rest-api/customers/create-customer.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.