/personBankAccounts.json

Creates a new bank account.

Field

Description

Type

Mandatory

fb_person_id

ID of a person

(once set this value could not be changed by a PUT request any more)

integer

yes

bank_account_owner

Name of the bank account owner

string (150)

If bank_bic, bank_iban, bank_account_number or bank_number is given, bank_account_owner must not be empty.

bank_number

Bank number

string (30)

bank_account_number

Bank account number

string (30)

bank_iban

IBAN

string (100)

bank_bic

BIC

string (100)

bank_name

Name of the bank

string (200)

bank_country

The country

2 letter country code

is_main

true if it is the main bank account

boolean

🚧

Mandatory fields

Please note that almost every field is optional, but there are some dependencies between fields! Therefor there are some special rules:

  • There must be a value for at least one field.
  • If bank_number is given, bank_account_number must not be empty.
  • If bank_account_number is given, bank_number must not be empty.
  • If bank_bic is given, bank_iban must not be empty.
  • If bank_account_owner is given, a combination of bank_bic/bank_iban resp. bank_account_number/bank_number must be given, too.

Errors according to the rules above results in a "bank_account_incomplete" error.

Language
Authentication
Basic
base64
:
Click Try It! to start a request and see the response here!