curl --request POST \
--url https://platform.swipelux.com/v3/customers \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-API-Key: <api-key>' \
--data '
{
"type": "individual"
}
'{
"data": {
"id": "cus_01JINDIVIDUAL",
"type": "individual",
"externalId": null,
"individual": {},
"financialProfile": {},
"metadata": {},
"createdAt": "2026-07-15T18:20:00.000Z",
"updatedAt": "2026-07-15T18:20:00.000Z"
}
}Create customer
Creates an individual or business customer. The request succeeds or fails as a whole. Individuals require only type; businesses also require business.legalName. Email and phone values do not have to be unique across customers.
curl --request POST \
--url https://platform.swipelux.com/v3/customers \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-API-Key: <api-key>' \
--data '
{
"type": "individual"
}
'{
"data": {
"id": "cus_01JINDIVIDUAL",
"type": "individual",
"externalId": null,
"individual": {},
"financialProfile": {},
"metadata": {},
"createdAt": "2026-07-15T18:20:00.000Z",
"updatedAt": "2026-07-15T18:20:00.000Z"
}
}Authorizations
Your Swipelux API key. Obtain this from the Swipelux Dashboard.
Headers
Required for effectful v3 requests (POST, PATCH, PUT, DELETE). Reuse the same key with the same body to replay the cached response.
1 - 255Body
- individual
- business
Create a strict v3 customer union. Unknown request fields are silently ignored.
individual Developer correlation identifier using 1-256 printable ASCII characters.
1 - 256^[\x20-\x7E]+$Reusable progressively collected individual identity facts.
Show child attributes
Show child attributes
Provider-neutral expected financial activity and funds-handling facts.
Show child attributes
Show child attributes
Developer-owned scalar metadata map with at most 50 entries.
Show child attributes
Show child attributes
Response
Customer created successfully
- individual
- business
Show child attributes
Show child attributes