Create Bank Account
Declare a bank account of the company.
The account is always created as a manual one, with no balance: the ponto and coda
accounts come from their own feed. It becomes the company’s default account if asked, or
automatically when the company does not have one yet.
In sandbox mode the body is validated exactly as in live mode but nothing is stored, so
the returned id is not resolvable.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
A bank account to create. The account is always created as a manual one: accounts
of the other origins are produced by their own feed (the banking connection for ponto,
a statement for coda) and cannot be declared through the API.
title, reference and bic are required — a manual account exists precisely to be
identified and paid into. Everything else about the account (origin, the balances,
currency, the timestamps) is derived or read-only, and rejected if sent.
Name of the account.
1 - 500The account's IBAN, validated (ISO 13616 structure and check digits) and stored uppercase without spaces. Must not already be used by another account of the company.
1 - 100BIC/SWIFT code of the institution.
1 - 11Whether this account is printed on the invoices the company issues.
Makes this account the company's default, demoting the previous one. Forced to true when the company has no default account yet, so that it always ends up with exactly one.
Response
Successful Response
A bank account of the company, identified by an opaque id.
Balances are decimal numbers in the account's currency; they are null for accounts
Fidly does not synchronise (a manual account carries no balance).
Opaque unique identifier of the bank account.
How the account came into Fidly. One of: ponto (synchronised through the banking connection), coda (created from a CODA statement), manual.
Name of the account.
Account reference, usually the IBAN.
BIC/SWIFT code of the institution.
Current balance of the account.
Balance actually available for spending.
ISO 4217 currency code of the balances (e.g. EUR).
true when this is the company's default account.
true when this account is printed on the invoices the company issues.
When the account was added to Fidly (ISO 8601).
When the account was last modified (ISO 8601).