Skip to content

Create a new customer for the merchant business. Idempotency-Key required on retries.

POST
/v1/customers
Idempotency-Key
string

Required on every mutating /v1/* endpoint (Phase 1 fixture relaxes to optional)

object
email
required
string format: email
/^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$/
name
string
metadata
object
key
additional properties
object
success
required
boolean
data
required
object
id
required
string
email
required
string
name
required
string
nullable
metadata
required
activeSubscriptionsCount
required
number
lifetimeValueMinor
required
string
status
required
string
Allowed values: active canceled none
createdAt
required
string format: date-time
meta
required
object
requestId
required
string