curl --request POST \
--url https://platform.swipelux.com/v3/customers/{customerId}/accounts \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-API-Key: <api-key>' \
--data '
{
"origin": "issued",
"type": "wallet",
"currency": "USDC",
"network": "base",
"label": "Treasury wallet"
}
'{
"data": {
"id": "acc_3eG7xN2pQ4rT8mA1sL6dVc",
"type": "wallet",
"network": "polygon",
"origin": "issued",
"status": "ready",
"openTaskIds": [],
"currency": "USDC",
"label": "Treasury wallet",
"isDefault": true,
"details": {
"network": "polygon",
"address": "0x1887b0a68bebc1b0d80a93567ba7002be92b8bd7"
},
"fees": {
"breakdown": {
"developer": null
}
},
"createdAt": "2026-06-25T12:05:00.000Z",
"updatedAt": "2026-06-25T12:05:00.000Z",
"archivedAt": null
}
}Create account
Create one customer account. Use origin: "issued" for platform-issued wallet accounts and virtual bank accounts, or origin: "external" for customer-owned wallet and bank accounts. Issued virtual bank accounts require settlement.accountId, the issued customer wallet account that receives settled funds.
curl --request POST \
--url https://platform.swipelux.com/v3/customers/{customerId}/accounts \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-API-Key: <api-key>' \
--data '
{
"origin": "issued",
"type": "wallet",
"currency": "USDC",
"network": "base",
"label": "Treasury wallet"
}
'{
"data": {
"id": "acc_3eG7xN2pQ4rT8mA1sL6dVc",
"type": "wallet",
"network": "polygon",
"origin": "issued",
"status": "ready",
"openTaskIds": [],
"currency": "USDC",
"label": "Treasury wallet",
"isDefault": true,
"details": {
"network": "polygon",
"address": "0x1887b0a68bebc1b0d80a93567ba7002be92b8bd7"
},
"fees": {
"breakdown": {
"developer": null
}
},
"createdAt": "2026-06-25T12:05:00.000Z",
"updatedAt": "2026-06-25T12:05:00.000Z",
"archivedAt": null
}
}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 - 255Path Parameters
Body
- Issued wallet account
- External wallet account
- Issued ACH account
- Issued wire account
- Issued SEPA account
- Issued SWIFT account
- Issued UAEFTS account
- Issued Faster Payments account
- Issued IPP account
- External ACH/wire account
- External SEPA account
- External SWIFT account
Account origin. Closed enum — exhaustive; additions would be a breaking change.
issued wallet Stablecoin to issue for this custodial wallet. Input is case-insensitive and normalized to upper case.
^\s*[Uu][Ss][Dd][CcTt]\s*$"USDC"
Blockchain network for this wallet account. Open enum — values are added over time; clients must tolerate unknown values.
polygon, ethereum, base, arbitrum, optimism, bsc, avalanche "base"
"Treasury wallet"
Response
Account created
Show child attributes
Show child attributes