Create a banking account
accounting:banks.writehttps://api.holded.com/api/v2/treasury/accountsCreates 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
Display name for the banking account
Banking account type
bankcardgatewaycashISO 4217 currency code
International Bank Account Number
Bank Identifier Code (SWIFT)
Local bank account number
SEPA creditor identifier for direct debits
Issuer identifier for payment orders
Request
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
{
"id": "507f1f77bcf86cd799439011"
}Success responses
201Banking account createdapplication/jsonError responses
400Bad requestapplication/json401Invalid or missing API keyapplication/json403Insufficient permissionsapplication/json422Validation errorapplication/json429Rate limit exceededapplication/json