JUjustifi
Payees

Create a Payee

Create a payee under this payer account. name, entity_type, tax_id and address are all required — together they are the identity a payee is paid and filed against, and none of them has a sensible default. A payee is still created without a bank account and has one registered later, through CreateBankAccount.

entity_type and tax_id are fixed here — they are the taxpayer the payee is filed against, and UpdatePayee does not accept them.

The payer account must be active. A payer account that is pending, disabled or archived creates nothing, and a payee create under one is refused with a 400.

post/payables/payer_accounts/{payer_id}/payees

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

namestring required

the payee's legal name

entity_type'c_corporation' | 's_corporation' | 'partnership' | 'limited_liability_company' | 'sole_proprietorship' required

the payee's IRS entity classification; no default, and not changeable later

tax_idstring required

the payee's taxpayer identification number — an EIN or an SSN, nine digits with or without separators. Which one it is follows entity_type: a sole_proprietorship files under the proprietor's SSN, or under an EIN where it has one; every other entity type files under an EIN. Write-only — it is stored encrypted and never returned; responses carry tax_id_last4. Payables does not validate it against the IRS, and does not check it against the entity type.

emailstring email
metadataobject

Example request

{
  "name": "Acme Plumbing LLC",
  "entity_type": "limited_liability_company",
  "tax_id": "12-3454021",
  "address": {
    "line1": "123 Example St",
    "line2": "Suite 101",
    "city": "Minneapolis",
    "state": "MN",
    "postal_code": "55555",
    "country": "USA"
  },
  "email": "billing@acmeplumbing.com",
  "metadata": {
    "erp_payee_id": "V-4021"
  }
}

Response

Payee 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": "payee",
  "data": {
    "id": "pe_abc123",
    "type": "payee",
    "payer_account_id": "payer_123xyz",
    "name": "Acme Plumbing LLC",
    "entity_type": "limited_liability_company",
    "email": "billing@acmeplumbing.com",
    "tax_id_last4": "4021",
    "address": {
      "line1": "123 Example St",
      "line2": "Suite 101",
      "city": "Minneapolis",
      "state": "MN",
      "postal_code": "55555",
      "country": "USA"
    },
    "receiving_bank_account_id": "ba_recv123",
    "status": "active",
    "metadata": {
      "erp_payee_id": "V-4021"
    },
    "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.