KintsugiKintsugi

Update bank details

PATCH/bank-details

Partial update of the organization's bank details. Fields you omit keep their stored value; a field sent as null is cleared. Creates the record when none exists. The response masks the account and routing numbers to their last four characters. Admin or Owner only for a user credential; an API key is permitted. 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-10-06.

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

bankNamestring

Name of the bank. Send null to clear it.

accountNumberstring

Bank account 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.

routingNumberstring

Bank routing number. Send null to clear it.

Response

idstringRequired

Opaque identifier of the bank-details record.

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.

routingNumberLast4stringRequired

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

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.

422

The request failed validation.

cURL
PATCH /bank-details
-H "Api-Key: ***"
-H "Api-Version: 2026-10-06"
{
"bankName": "First National Bank",
"accountNumber": "000123456789",
"accountType": "CHECKING",
"accountHolderName": "Acme, Inc.",
"routingNumber": "110000000"
}
Response
{
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"bankName": "First National Bank",
"accountNumberLast4": "6789",
"accountType": "CHECKING",
"accountHolderName": "Acme, Inc.",
"routingNumberLast4": "0000"
}
Update bank details (2026-10-06) | Kintsugi API Reference