Create a new customer
Create a new customer for a merchant
Authorization
X-API-Key
<token>In: header
Request Body
application/json
OptionalfirstName
RequiredstringThe first name of the customer
1
Maximum length: 1024
middleName
stringThe middle name of the customer
1
Maximum length: 1024
lastName
RequiredstringThe last name of the customer
1
Maximum length: 1024
email
RequiredstringThe primary email address of the customer
"email"
phone
RequiredstringThe primary phone number of the customer in E.164 format (e.g., +1234567890)
1
Maximum length: 32
metadata
objectThe provided metadata of the customer
birthDate
RequiredstringThe date of birth of the customer in ISO 8601 format (YYYY-MM-DD)
"date"
residentialAddress
RequiredobjectThe residential address of the customer
identifyingInformation
Requiredarray<object>An array of identifying information for the customer
Response Body
The customer was created successfully
id
RequiredstringA unique identifier for the customer
firstName
RequiredstringThe first name of the customer
1
Maximum length: 1024
middleName
stringThe middle name of the customer
1
Maximum length: 1024
lastName
RequiredstringThe last name of the customer
1
Maximum length: 1024
email
RequiredstringThe primary email address of the customer
"email"
phone
RequiredstringThe primary phone number of the customer in E.164 format (e.g., +1234567890)
1
Maximum length: 32
status
RequiredunknownThe KYC verification status of the customer
"not_started" | "incomplete" | "under_review" | "approved" | "rejected"
metadata
objectThe provided metadata of the customer
createdAt
RequiredstringThe creation date of the customer
"date-time"
updatedAt
RequiredstringThe last update date of the customer
"date-time"