Skip to main content

Set the Default Bank Account

Makes this bank account the one used when no bank account is named in its currency: deposits that name none, withdrawals, and buying or selling crypto.

An account has at most one default per currency. The bank account that held it before, in the same currency and for the same account, stops being the default in the same step. Until one is set, the account's first bank account in a currency is its default. Doing this on the bank account that is already the default changes nothing.

New in v3: v2 has no equivalent.

Authorization:

Every request is signed with your API key: a short-lived JWT, signed with your private key, sent in one header on /v3/* and /api/v2/* alike.

Headers:
  Authorization: APIKey {SIGNED_JWT}

How to build and sign the JWT: Authentication.

Endpoint

POST

/v3/bank-accounts/{bank_account_id}/default

Path parameters​

ParameterTypeDescription
bank_account_idstring (bnk_…)Required. The bank account to make the default.

There is no request body.

An account-scoped key sets the default only among its own account's bank accounts; another account's reads as 404. A workspace-scoped key can name any bank account of the workspace; the change applies to the account that holds it.

Response Sample​

{
  "id": "bnk_01k8x4p6sx9t5v7x1z3b5d7f9h",
  "customer_id": "cst_01h455vb4pex5vsknk084sn02q",
  "kind": "deposit",
  "name": "Payroll",
  "reference": "K7Q2MZ",
  "account_number": "555000114027",
  "currency": "USD",
  "status": "active",
  "is_default": true,
  "created_at": "2026-10-01T09:12:30Z",
  "updated_at": "2026-10-14T16:42:57Z"
}

Response Schema​

The bank account, now with is_default: true, and the fields of a List Bank Accounts row.

Errors​

StatusmessageWhen
400failed to parse requestbank_account_id is not a bnk_… id.
401unauthorizedMissing or invalid signature.
404bank_account_not_foundNo such bank account, or it belongs to another account.
409bank_account_inactiveThe bank account is inactive: it keeps its history but takes no more money, so it cannot be the default.

Support and Resources​

If you need assistance or have any questions, our support team is here to help. You can contact our support team at support@blockwyre.com.

Stay Updated​

Stay up-to-date with the latest news, updates, and features from BlockWyre by following us on social media:

We are excited to have you on board and look forward to seeing how you leverage BlockWyre's powerful tools to enhance your financial operations. Happy integrating!