Create a bank account

POSThttps://app.speybooks.com/api/v1/bank-accounts/

Creates a bank account for the authenticated organisation, linked automatically to the seeded Bank Current Account (BANK_CURRENT control type). The first account created is primary.

Requires bankName. sortCode and accountNumber are optional but format-checked when present: sort code must be six digits with optional separators (e.g. 60-83-71), account number must be eight digits.

Returns the created account in the same shape as listBankAccounts, so the frontend can immediately select it and proceed to import.

Only one bank account linked to a given chart account is permitted. Attempting a second create returns 409.

Body parameters

bankNamestringrequired
Name of the bank (e.g. Starling, NatWest).
accountNamestringoptional
Display name for this account (optional).
accountNumberstringoptional
UK account number, eight digits. Optional.
sortCodestringoptional
UK sort code, six digits with optional separators (e.g. 60-83-71). Optional.

Response

201Bank account created. Returns the new account in the same shape as listBankAccounts.
Show response fields
bankAccountobject
Show child attributes
accountIdinteger
accountNamestringnullable
accountNumberstringnullable
bankNamestring
idinteger
isPrimaryboolean
sortCodestringnullable