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 the canonical customer union atomically. Individuals require only type; businesses require business.legalName. Email and phone values are not unique customer keys.
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
- Option 1
- Option 2
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
- Option 1
- Option 2
Show child attributes
Show child attributes