Skip to main content
POST
Create customers

Authorizations

Api-Access-Key
string
header
required

An API key associated with a security role

Headers

Idempotency-Key
string
required

Client-supplied key that deduplicates retried requests. Reusing a key returns the original result instead of repeating the action.

Api-Signature
string
required

A hex-encoded Ed25519 signature of timestamp_epoch_seconds + uppercase(http_method) + request_path + request_body.

Pattern: ^[0-9A-Fa-f]{128,160}$
Api-Timestamp
integer<int64>
required

Current timestamp, represented as unix epoch seconds

Body

application/json

Customers to create

Request to create a new individual customer

customerType
enum<string>
default:INDIVIDUAL
required

Discriminator — always INDIVIDUAL

Available options:
INDIVIDUAL
externalId
string
required

External identifier provided by the client

firstName
string
required

First name of the individual

lastName
string
required

Last name of the individual

email
string<email>
required

Email address

idNumber
string
required

Government-issued identification number

address
Customer Address · object
required

A structured postal address

dateOfBirth
string<date>

Date of birth

Response

Accepted

Per-item results for a batch customer creation request.

data
(Batch Item Success Result · object | Batch Item Error Result · object)[]
required

Successful outcome for one item of a batch request.