Skip to main content
POST

Create a banking account

Scope:accounting:banks.write
https://api.holded.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
namestringrequired

Display name for the banking account

typestringrequired

Banking account type

Enum:bankcardgatewaycash
currencystringoptional

ISO 4217 currency code

ibanstring | nulloptional

International Bank Account Number

bicstring | nulloptional

Bank Identifier Code (SWIFT)

account_numberstring | nulloptional

Local bank account number

creditor_idstring | nulloptional

SEPA creditor identifier for direct debits

issuer_idstring | nulloptional

Issuer identifier for payment orders

Request

python
import requests

url = "https://api.holded.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

json
{
  "id": "507f1f77bcf86cd799439011"
}

Success responses

201Banking account createdapplication/json
object
idstring

Error responses

400Bad requestapplication/json
401Invalid or missing API keyapplication/json
403Insufficient permissionsapplication/json
422Validation errorapplication/json
429Rate limit exceededapplication/json