v1

latestOpenAPI 3.1.02026-07-244511495.5 KB

Accounts

Create account

post/v1/customers/{customer_id}/accounts

Path parameters

customer_idstring uuid required

Headers

Idempotency-Keystring uuid required

Idempotency key to allow safe retrying of the operation. The value should be a unique UUID for each distinct operation. See our understanding idempotency guide for full details.

Request body

account_namestring string required

Friendly label set by the client

account_type'payment' | 'virtual' required

The type of account to be created. Note: 'Payment' is deprecated and not supported for new accounts. Account type will always be 'Virtual'.

currency'AED' | 'USD' | 'JOD' | 'EGP' | 'SAR' | 'GBP' | 'EUR' | 'HKD' | 'CNH' | 'SGD' required

external_idstring string required

Id to be set by the client

Response

The request to create an account has been accepted

account_idstring uuid required