Scope: accounting:banks.write https://api.alladdin.com/api/v2/treasury/accounts

Creates a new banking account in your account. Banking accounts represent your bank accounts, credit cards, cash registers, or payment gateways — they track cash positions and transaction history.
The response returns the new banking account id. You must specify a type (bank, card, gateway, or cash) and optionally provide bank details like IBAN and BIC.
Accounts created through this endpoint are manually-managed: they have no bank connection and won't auto-sync movements. To onboard a bank-connected account, use the in-app Banking onboarding flow.

Request body

object name string required

Display name for the banking account

type string required

Banking account type

Enum: bank card gateway cash currency string optional

ISO 4217 currency code

iban string | null optional

International Bank Account Number

bic string | null optional

Bank Identifier Code (SWIFT)

account_number string | null optional

Local bank account number

creditor_id string | null optional

SEPA creditor identifier for direct debits

issuer_id string | null optional

Issuer identifier for payment orders

Request

import requests

url = "https://api.alladdin.com/api/v2/treasury/accounts"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

payload = {
    "name": "Main bank account",
    "type": "bank",
    "currency": "EUR",
    "iban": "string",
    "bic": "string",
    "account_number": "string",
    "creditor_id": "string",
    "issuer_id": "string"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

Responses

Response

{
  "id": "507f1f77bcf86cd799439011"
}

Success responses

201 Banking account created application/json object id string

Error responses

400 Bad request application/json 401 Invalid or missing API key application/json 403 Insufficient permissions application/json 422 Validation error application/json 429 Rate limit exceeded application/json

← PreviousList banking accounts →

Next →Get a banking account by ID →