Create Customer
Customers
Create Customer
Create a new customer
POST
Create Customer
Create Customer
Creates a new customer record in the store. Requires thewrite_customers scope.
Request
Body Parameters
Customer email address (must be unique)
Customer’s first name
Customer’s last name
Customer’s phone number
Whether customer has opted in to marketing emails
Internal notes about the customer
Array of tags. Accepted by the request but not persisted — a customer record
has no tags field.
Array of address objects. Only the first address is persisted, and only
its flat fields (
address1, city, province, country, zip, phone)
are stored on the customer record — there is no separate addresses
collection. Subsequent addresses are ignored.A customer record stores a single combined name (built from
first_name +
last_name), one phone number, the marketing flag, a note, and one flat
address. Tags are not stored, and only the first address is persisted.Response
The response is a bare object keyed bycustomer containing the newly created,
Shopify-shaped customer object (the same shape returned by the read endpoints).
There is no { status, data } envelope.
The created customer object
Example Response
Errors
Errors are returned as a Shopify-style{ "errors": { "base": ["..."] } } body
with the corresponding HTTP status code.
| Status | Description |
|---|---|
400 | email is missing, or a customer with this email already exists |
401 | Invalid or missing access token |
403 | App doesn’t have the write_customers scope |