Create customer
Authentication
Headers
Scope the request to a specific store / account instead of the one resolved from the API key. Aliases: the x-account-id header, or the application_account_id / account_id query parameter.
Scope the request to a specific store / account instead of the one resolved from the API key. Aliases: the x-account-id header, or the application_account_id / account_id query parameter.
Creates a new customer record scoped to the authenticated merchant’s store. The storeId is derived from the API key context (not supplied in the body), and a UUID id is generated server-side.
x-api-key header (alias x-account-api-key).Merchant.customer.create.x-application-account-id header (alias x-account-id) or the application_account_id / account_id query param.JSON body (application/json). Only name and email are required. The optional fields accepted by CreateCustomerDto are mobile, addressLine1, addressLine2, city, state, postalCode and country. Unknown properties are stripped by the validation pipe.
"A customer with this email already exists for your store.").Notas: storeId and id are set server-side and cannot be supplied by the client. Email uniqueness is enforced per store (case-insensitive) and returns 400 on conflict. Related endpoints: GET /v1/customers, PATCH /v1/customers/:id.