Create an entity bank account

POST

Add a new bank account for the specified entity.

The minimum required fields are currency and country. Other required fields depend on the currency:

  • EUR accounts require iban.
  • GBP accounts require account_holder_name, account_number, and sort_code.
  • USD accounts require account_holder_name, account_number, and routing_number.
  • Accounts in other currencies require one of:
    • iban
    • account_number and sort_code
    • account_number and routing_number

Headers

Auth
AuthorizationstringRequired
Bearer authentication of the form Bearer <token>, where token is your auth token.
x-monite-versionstringRequired
x-monite-entity-idstringRequired
The ID of the entity that owns the requested resource.

Request

This endpoint expects an object.
countryenumRequired

The country in which the bank account is registered, repsesented as a two-letter country code (ISO 3166-1 alpha-2).

currencyenumRequired

The currency of the bank account, represented as a three-letter ISO currency code.

account_holder_namestringOptional
The name of the person or business that owns this bank account. Required if the account currency is GBP or USD.
account_numberstringOptional
The bank account number. Required if the account currency is GBP or USD. UK account numbers typically contain 8 digits. US bank account numbers contain 9 to 12 digits.
bank_namestringOptional
The bank name.
bicstringOptional
The SWIFT/BIC code of the bank.
display_namestringOptional
User-defined name of this bank account, such as 'Primary account' or 'Savings account'.
ibanstringOptional
The IBAN of the bank account. Required if the account currency is EUR.
is_default_for_currencybooleanOptional

If set to true or if this is the first bank account added for the given currency, this account becomes the default one for its currency.

routing_numberstringOptional
The bank's routing transit number (RTN). Required if the account currency is USD. US routing numbers consist of 9 digits.
sort_codestringOptional
The bank's sort code. Required if the account currency is GBP.

Response

This endpoint returns an object
idstring
Unique ID of the bank account.
account_holder_namestringOptional
The name of the person or business that owns this bank account. Required if the account currency is GBP or USD.
account_numberstringOptional
The bank account number. Required if the account currency is GBP or USD. UK account numbers typically contain 8 digits. US bank account numbers contain 9 to 12 digits.
bank_namestringOptional
The bank name.
bicstringOptional
The SWIFT/BIC code of the bank.
countryenumOptional

The country in which the bank account is registered, repsesented as a two-letter country code (ISO 3166-1 alpha-2).

currencyenumOptional

The currency of the bank account, represented as a three-letter ISO currency code.

display_namestringOptional
User-defined name of this bank account, such as 'Primary account' or 'Savings account'.
ibanstringOptional
The IBAN of the bank account. Required if the account currency is EUR.
is_default_for_currencybooleanOptional
Indicates whether this bank account is the default one for its currency.
routing_numberstringOptional
The bank's routing transit number (RTN). Required if the account currency is USD. US routing numbers consist of 9 digits.
sort_codestringOptional
The bank's sort code. Required if the account currency is GBP.
was_created_by_user_idstringOptional

ID of the entity user who added this bank account, or null if it was added using a partner access token.

Errors