GuidesAPI ReferenceChangelog
Changelog
Improved

v1.0.13

institution_name is now optional

The endpoints below have been simplified, the institution_name field is no longer required when creating external accounts. We now automatically resolve the correct bank name using the institution_id, reducing failures due to mismatches on bank names.

Affected endpoints:

POST /v1/customers/{customer_id}/external-accounts
POST /v1/customers/{customer_id}/recipients/{recipient_id}/bank-accounts
POST /v1/customers/{customer_id}/recipients (with inline bank_accounts)
👍

No breaking changes — existing integrations that already send institution_name will continue to work as before.


Request example:

{
  "network": "US_ACH",
  "currency": "USD",
  "country_code": "USA",
  "account_number": "123456789",
  "institution_id": "021000021"
}

The response will include the resolved institution_name:

{
  "institution_id": "021000021",
  "institution_name": "JPMorgan Chase Bank, N.A.",
  ...
}

New error code:

CodeStatusDescription
00020008400 Bad RequestInstitution not found for the provided routing code.