KintsugiKintsugi

Update one bank account

PATCH/bank-details/{bank_details_id}

Updates one bank account. A field you omit keeps its stored value. Send null to clear a field that can be empty. An empty body changes nothing. This route does not change the debit account. Call set-primary to choose the debit account. The response shows the last four characters of the account number and the routing number. 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.

Path parameters

bank_details_idstringRequired

Body

countrystring

Country of the account. Omit it to keep the stored country. Null is not accepted.

bankNamestring

Name of the bank. Send null to clear it.

accountNumberstring

Bank account number. Send null to clear it.

routingNumberstring

Bank routing number. Send null to clear it.

accountTypePublicBankAccountTypeEnum

Account type. Send null to clear it.

Available options:CHECKINGSAVINGS
accountHolderNamestring

Name on the account. Send null to clear it.

accountHolderTypePublicBankAccountHolderTypeEnum

Whether the account belongs to an individual or a business. Send null to clear it.

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.

200

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
PATCH /bank-details/{bank_details_id}
-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"
}
Example request
https://api.trykintsugi.com/bank-details/{bank_details_id}
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
}
Update one bank account (2026-07-21) | Kintsugi API Reference