POST
Create customer

Authorizations

Authorization
string
header
required

Authorization: Bearer cl_test_sk_... (sandbox) or Bearer cl_live_sk_... (live). A live key additionally needs production enabled by the workspace owner. Using a live key against the sandbox path revokes it on sight (leak signal); a sandbox key on live is refused and logged, but not revoked.

X-Workspace-Id
string
header
required

The workspace (tenant) UUID. Always required, including on session-authenticated dashboard calls.

Path Parameters

env
enum<string>
required

test is also accepted on the wire as an alias of sandbox; the key prefix must match (cl_test_sk_ for sandbox/test, cl_live_sk_ for live).

Available options:
sandbox,
live

Body

application/json
kind
enum<string>
default:person
Available options:
person,
business
display_name
string
default:Customer
document_type
string
document_number
string
email
string
phone
string
country
string
external_id
string
metadata
object
payout_mode
string
payout_asset
string
payout_wallet_address
string
payout_wallet_network
string

Only kept when it is one of the supported networks.

Response

OK

data
object
required

A party of kind customer. Fields mirror CreateCustomerRequest plus server-assigned ones.