Sign in

v1

latestOpenAPI 3.0.32026-07-2642021.4 KB
Financial Institutions

Create a new external financial institution

Links an external bank account to the specified account (ACH, wire, etc.).

Deprecated. Use Addresses. Create an off-chain Address (ACH/Wire/RTP) and pass its address_id to Transfers. Plaid endpoints have moved to /accounts/{account_id}/plaid/*.

post/accounts/{account_id}/financial-institutions/external

Path parameters

account_idstring ksuid required
Example:2VcUIIsgARwVbEGlIYbhg6fGG57

The ID of the account

Headers

Idempotency-Keystring required

A unique string used to prevent duplicate operations. Each POST request must use a new idempotency key. Use a UUIDv4 string. Example: idemp-123e4567-e89b-12d3-a456-426614174000

Request body

namestring required
transfer_typestring[] required

Example request

{
  "name": "Business Checking Account",
  "transfer_type": [
    "ach",
    "wire"
  ],
  "bank_details": {
    "owner": "Jane Doe",
    "account_number": "1234567890",
    "name": "Example Bank",
    "address": {
      "street_line_1": "123 Main St",
      "street_line_2": "Apt C",
      "city": "Des Moines",
      "state": "Iowa",
      "zip": "12345"
    },
    "account_type": "checking"
  }
}

Response

Financial institution successfully created