Create a customer
Creates a new customer under your merchant account. The email address
must be unique per merchant per mode. Supplying billing_address or
shipping is optional; both can be added or changed later via the
update endpoint. creation_source defaults to api when omitted.
Authorizations
A merchant secret key (sk_…) sent as Authorization: Bearer <key>.
Headers
A unique key that makes retries safe: the same key with the same request body returns the original response instead of repeating the operation.
255Body
Customer email address. Must be unique per merchant and mode.
Origin of the record (defaults to api when omitted).
Billing address. Can be added later.
Shipping details. Can be added later.
Up to 50 key/value pairs. Keys ≤ 40 chars, values ≤ 500 chars.
Response
The created customer.
Unique customer identifier (cus_…).
customer Whether this customer was created with a live (true) or test (false) key.
Empty string when not set.
Empty string when not set.
Empty string when not set.
Billing address; null when not set.
Shipping details; null when not set.
How the customer was created (for example api).
api, checkout, import, dashboard, platform Payment configuration stored for the customer.
True when the customer has been soft-deleted.
Unix epoch seconds.

