KintsugiKintsugi

Create bank account

POST/bank-details

Adds one bank account for the organization. The first account becomes the debit account. A later account does not replace it. Call set-primary to choose a different debit account. The response masks the account and routing numbers to their last four characters. An Owner or Admin can call this route, and an API key can too. The organization is selected by Organization-Id, Connection-Id, or Entity-Id.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Target organization id (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Body

countrystringRequired

Country of the account.

bankNamestring

Name of the bank.

accountNumberstring

Bank account number.

routingNumberstring

Bank routing number.

accountTypePublicBankAccountTypeEnum

Account type.

Available options:CHECKINGSAVINGS
accountHolderNamestring

Name on the account.

accountHolderTypePublicBankAccountHolderTypeEnum

Whether the account belongs to an individual or a business.

Available options:INDIVIDUALBUSINESS

Response

idstringRequired

Opaque identifier of the bank-details record.

countrystringRequired

Country of the account.

bankNamestringRequired

Name of the bank, or null when not captured.

accountNumberLast4stringRequired

Last four characters of the account number, or null when not captured.

accountTypePublicBankAccountTypeEnumRequired

Account type, or null when not captured.

Available options:CHECKINGSAVINGS
accountHolderNamestringRequired

Name on the account, or null when not captured.

accountHolderTypePublicBankAccountHolderTypeEnumRequired

Whether the account belongs to an individual or a business, or null when not captured.

Available options:INDIVIDUALBUSINESS
routingNumberLast4stringRequired

Last four characters of the routing number, or null when not captured.

isPrimarybooleanRequired

True when this account is the organization's debit account.

201

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

409

The request conflicts with existing state.

422

The request failed validation.

cURL
POST /bank-details
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"country": "US",
"bankName": "First National Bank",
"accountNumber": "000123456789",
"routingNumber": "110000000",
"accountType": "CHECKING",
"accountHolderName": "Acme, Inc.",
"accountHolderType": "INDIVIDUAL"
}
Response
{
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"country": "US",
"bankName": "First National Bank",
"accountNumberLast4": "6789",
"accountType": "CHECKING",
"accountHolderName": "Acme, Inc.",
"accountHolderType": "INDIVIDUAL",
"routingNumberLast4": "0000",
"isPrimary": false
}
Create bank account (2026-07-21) | Kintsugi API Reference