Create a business account

OAuth scope: bank_account.write

Creates a new business account.

A business account allows you to receive funds, make payments, and manage your finances. Each business account has its own IBAN and balance, and can be used for a variety of banking operations.

You can create multiple business accounts and name them based on your business needs (e.g., Primary Account, Project ABC, Tax Pots). This flexibility helps you organize your finances and allocate funds for specific purposes.

Idempotency Header: This endpoint requires the X-Qonto-Idempotency-Key header to safely retry requests without accidentally performing the same operation twice. The key should be a unique string (preferably a UUID) for each unique request. If you retry a request with the same idempotency key within 30 minutes, the original response will be returned without executing the request again. After 30 minutes, the key expires and can be reused.

POST

bank_accounts

curl --request POST \
  --url https://thirdparty.qonto.com/v2/bank_accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Qonto-Idempotency-Key: <x-qonto-idempotency-key>' \
  --data '{
  "bank_account": {
    "name": "Secondary business account"
  }
}'

{
  "bank_account": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "Primary bank account",
    "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "active",
    "main": true,
    "iban": "FR7610004000000112345678901",
    "bic": "BNPAFRPPXXX",
    "currency": "EUR",
    "balance": 142188.43,
    "balance_cents": 14218843,
    "authorized_balance": 141148.12,
    "authorized_balance_cents": 14114812,
    "updated_at": "2024-04-03T12:00:00.000Z",
    "is_external_account": false,
    "account_number": 1234567890
  }
}

Authorizations

Authorization

string

header

required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

X-Qonto-Staging-Token

string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

X-Qonto-Idempotency-Key

string

required

A unique key to prevent duplicate requests. Keys expire after 30 minutes and can be reused.

Body

application/json

Response

200

application/json

Business account created successfully

The response is of type object.

List business accounts Get a business account

curl --request POST \
  --url https://thirdparty.qonto.com/v2/bank_accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Qonto-Idempotency-Key: <x-qonto-idempotency-key>' \
  --data '{
  "bank_account": {
    "name": "Secondary business account"
  }
}'

{
  "bank_account": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "Primary bank account",
    "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "active",
    "main": true,
    "iban": "FR7610004000000112345678901",
    "bic": "BNPAFRPPXXX",
    "currency": "EUR",
    "balance": 142188.43,
    "balance_cents": 14218843,
    "authorized_balance": 141148.12,
    "authorized_balance_cents": 14114812,
    "updated_at": "2024-04-03T12:00:00.000Z",
    "is_external_account": false,
    "account_number": 1234567890
  }
}