Skip to main content
POST
/
v2
/
bank_accounts
Create 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:00Z",
    "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

Learn more in Idempotent Requests.

Example:

"123e4567-e89b-12d3-a456-426614174000"

Body

application/json
​
bank_account
object
required

Response

Business account created successfully

​
bank_account
object
required