Skip to main content
POST
Create a customer of a store

Authorizations

Authorization
string
header
required

Secret, platform or publishable API key. Platform keys require Payments-Account.

Headers

payments-account
string
payments-version
enum<string>
Available options:
2026-11-01
idempotency-key
string
required
Required string length: 1 - 255

Body

application/json
billing_address
object
email
string<email>
Maximum string length: 254
first_name
string
Required string length: 1 - 200
last_name
string
Required string length: 1 - 200
locale
string
Pattern: ^[a-z]{2}(-[A-Z]{2})?$
metadata
object
shipping_address
object
store
string
Pattern: ^store_[a-f0-9]{12}$

Response

Customer, shared with the CRM.

billing_address
object | null
required
created_at
string<date-time>
required
email
string | null
required
first_name
string | null
required
id
string
required
Pattern: ^cus_[a-f0-9]{12}$
last_name
string | null
required
locale
string | null
required
metadata
object
required
object
enum<string>
required
Available options:
customer
shipping_address
object | null
required
store
string | null
required
Pattern: ^store_[a-f0-9]{12}$