JUjustifi
Bank Account

Create a Bank Account

Create a bank account

post/entities/bank_accounts

Request

Headers

Authorizationstring required

the access_token value returned from the JustiFi oauth/token endpoint (be sure to append Bearer before the token)

Request body

account_owner_namestring required

name of the account owner

account_type'checking' | 'savings' required

type of account

account_numberstring required

the account number

routing_numberstring

9-digit routing number. Required for US bank accounts; not accepted for Canadian bank accounts

institution_numberstring

3-digit institution number identifying the bank. Required for Canadian bank accounts; not accepted for US bank accounts

transit_numberstring

5-digit transit number identifying the bank branch. Required for Canadian bank accounts; not accepted for US bank accounts

business_idstring uuid required

business id which owns the account

bank_namestring

bank name

nicknamestring

nickname for the bank account

metadataobject

any useful information you'd like to store alongside this bank account

Example request

{
  "account_owner_name": "Napheesa Collier",
  "account_type": "checking",
  "account_number": "000123456789",
  "routing_number": "110000000",
  "institution_number": "001",
  "transit_number": "12345",
  "business_id": "biz_abc123",
  "bank_name": "Wells Fargo",
  "nickname": "Phee's Money",
  "metadata": {
    "my_id": "123"
  }
}

Response

Bank Account was created successfully

idstring uuid

the object id, also found in the data object

typestring

the object type, or array of objects

page_infounknown

Example response

{
  "id": "prefix_xyz (same as id of data object)",
  "type": "bank_account",
  "data": {
    "id": "ba_123xyz",
    "account_owner_name": "Napheesa Collier",
    "account_type": "checking",
    "account_number_last4": "6789",
    "routing_number": "110000000",
    "bank_name": "Wells Fargo",
    "country": "USA",
    "nickname": "Phee's money",
    "metadata": {},
    "business_id": "biz_123abc",
    "platform_account_id": "acc_123abc",
    "created_at": "2021-01-01T12:00:00Z",
    "updated_at": "2021-01-01T12:00:00Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.