Open account

POST

/baas/Accounts

Opens an account in the requested currency for an active client. The currency must be enabled for your
integration.

The account is opened within this request, and the response contains its identifier. Payment credentials
(for example, an IBAN or an account number) are then issued asynchronously for each payment method available
for the currency. Each result is reported with a credentialsIssued or credentialsIssueFailed webhook; you
can also follow it with GET /baas/Accounts/{id}.

externalId is your identifier of the account; a request with the externalId of an existing account is
rejected.

Errors:

404 Not Found - the client does not exist or is not active yet;

409 Conflict - an account with this externalId already exists;

422 Unprocessable Content - an account cannot be opened in this currency.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/json

Example

{
    "externalId": "string",
    "clientId": "5e505642-9024-474d-9434-e5a44f505cc5",
    "currency": "string",
    "paymentMethod": "sepa"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/baas/Accounts' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "externalId": "string",
    "clientId": "5e505642-9024-474d-9434-e5a44f505cc5",
    "currency": "string",
    "paymentMethod": "sepa"
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

🟠400

🟠404

🟠422

🔴500

Modified at 2026-09-29 12:10:42

Handle webhooks

List accounts