Skip to main content
POST
Typescript (SDK)

Authorizations

Authorization
string
header
required

API key in the format: Bearer {api_token}

Headers

Idempotency-Key
string

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Maximum string length: 255

Body

application/json
metadata
object

Set of key-value pairs you can attach to the object — store your own system's IDs or grouping labels. Keys max 40 chars (up to 50 keys), values stored as strings max 500 chars. On update, keys merge individually; set a key to null or "" to remove it. Echoed back on reads and in webhook payloads.

Response

Customer created

id
string
required
object
string
required
email
string
required
name
string | null
required
first_name
string | null
required
last_name
string | null
required
customer_type
enum<string>
required
Available options:
paid,
free,
lead
notes
string | null
required
confirmed_at
string<date-time> | null
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
metadata
object
required
orders_count
integer
required
total_spend
number
required
tags
array
required