Skip to main content
POST
Create Bank Account

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

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.

title
string
required

Name of the account.

Required string length: 1 - 500
reference
string
required

The 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.

Required string length: 1 - 100
bic
string
required

BIC/SWIFT code of the institution.

Required string length: 1 - 11
display_on_invoice
boolean
default:true

Whether this account is printed on the invoices the company issues.

default
boolean
default:false

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).

id
string
required

Opaque unique identifier of the bank account.

origin
string
required

How the account came into Fidly. One of: ponto (synchronised through the banking connection), coda (created from a CODA statement), manual.

title
string | null
required

Name of the account.

reference
string | null
required

Account reference, usually the IBAN.

bic
string | null
required

BIC/SWIFT code of the institution.

current_balance
number | null
required

Current balance of the account.

available_balance
number | null
required

Balance actually available for spending.

currency
string | null
required

ISO 4217 currency code of the balances (e.g. EUR).

default
boolean
required

true when this is the company's default account.

display_on_invoice
boolean
required

true when this account is printed on the invoices the company issues.

created_at
string<date-time> | null
required

When the account was added to Fidly (ISO 8601).

updated_at
string<date-time>
required

When the account was last modified (ISO 8601).