JUjustifi
Payee Bank Accounts

Create a Payee Bank Account

Register a receiving bank account for a payee under this payer account (the account a payment is paid to). The account_number is write-only — it is accepted here but never returned; responses expose only account_number_last4.

Funding accounts cannot be created here. The payer account's own funding account — the one payments are pulled from — is set during provisioning and replaced by JustiFi rather than through this API, because it decides where money is taken from. This endpoint creates payee receiving accounts only, and they are created not_required: Payables does not validate payee accounts. You can still read funding accounts through ListBankAccounts and GetBankAccount.

In this version an owner has a single active bank account — creating one for a payee that already has an active account supersedes the previous one.

The payer account must be active and the payee must not be archived. Either one is a 400: a payer account that is not active registers nothing, and an archived payee can never be paid, so it has nothing to be paid to.

A disabled payee may still register an account, and doing so returns it to active. That is the way back for a payee Payables disabled because its bank refused the credit or corrected the account without saying what to: register the corrected numbers and the payee is payable again, along with any payment still held for it.

post/payables/payer_accounts/{payer_id}/bank_accounts

Request

Path parameters

payer_idstring required

the payer account this request is scoped to. Every payee, bank account, and payment lives under one payer account, so it is part of the path on all operate (Tier 1) routes.

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_holder_namestring required
routing_numberstring required
account_numberstring required

the full account number; write-only, never returned

account_type'checking' | 'savings' required
payee_idstring required

the payee this receiving account belongs to. The payee must be scoped to the payer account in the path.

Example request

{
  "account_holder_name": "Acme Plumbing LLC",
  "routing_number": "021000021",
  "account_number": "123456789",
  "account_type": "checking",
  "payee_id": "pe_abc123"
}

Response

Bank account was created successfully

idstring required

the object id, also found in the data object

typestring required

the object type

page_infounknown required

Example response

{
  "id": "prefix_xyz (same as id of data object)",
  "type": "bank_account",
  "data": {
    "id": "ba_recv123",
    "type": "bank_account",
    "account_holder_name": "Acme Plumbing LLC",
    "routing_number": "021000021",
    "account_number_last4": "6789",
    "account_type": "checking",
    "payee_id": "pe_abc123",
    "verification_status": "verified",
    "created_at": "2026-01-01T12:00:00Z",
    "updated_at": "2026-01-01T12:00:00Z"
  }
}

Changes

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