API version

API reference / Set primary bank account

Set primary bank account

POST/bank-details/{bank_details_id}/set-primary

Sets the named bank account as the organization's debit account. Requires a user credential (an API key is rejected) that is an Owner or Admin of the organization selected by Organization-Id, Connection-Id, or Entity-Id. The response masks the account and routing numbers to their last four characters.

Authorization

AuthorizationstringRequired

A signed-in user's session token (Authorization: Bearer <token>). It authorizes the organizations that user can reach. Managing people or API keys accepts this token. A portfolio API key can also manage API keys; an organization or client key cannot.

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

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

POST /bank-details/{bank_details_id}/set-primary

-H "Authorization: Bearer ***"

-H "Api-Version: 2026-10-06"

Example request

https://api.trykintsugi.com/bank-details/{bank_details_id}/set-primary

Response

{

"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",

"bankName": "First National Bank",

"accountNumberLast4": "6789",

"accountType": "CHECKING",

"accountHolderName": "Acme, Inc.",

"routingNumberLast4": "0000"

}