---
title: "bank-account/set-my-bank-account"
method: POST
path: "/bank-account/set-my-bank-account"
tags: ["Bank Account Endpoints"]
---

# bank-account/set-my-bank-account

`POST /bank-account/set-my-bank-account`

## Request

- Base URL: `https://earthnode-dev.vopay.com/api/v2`
- URL: `https://earthnode-dev.vopay.com/api/v2/bank-account/set-my-bank-account`
- Auth: none declared

This endpoint allows you to identify a bank account as belonging to the VoPay account holder.

 Optionally, you can use this endpoint to identify a bank account as being the VoPay account holder's default operational and/or billing bank account. The VoPay account holder's default operational bank account is used in the /account/fund-my-account and /account/withdraw-my-account endpoints. The VoPay account holder's default billing bank account is used to collect monthly invoices. Note, a VoPay account can only have one default operational and one default billing bank account per currency.

## Request body `application/x-www-form-urlencoded`

- object
  - `AccountID` string, required: Your account ID
  - `Key` string, required: API key for the account
  - `Signature` string, required: Hashed signature for the request
  - `Token` string, required: Bank account token
  - `ClientAccountID` string: Client Account ID. Not valid for partner accounts, which have no client accounts; supplying it returns an INVALID_PARAMETER error.
  - `SetAsDefault` boolean: Identify bank account as a default bank account
  - `Purpose` string: Identify bank account purpose. Input can be a comma-delimited list. Valid values are: operational and billing. Default value is operational.

## Response `200`

- object
  - `Success` boolean, required: True if the request was successful, false if it failed
  - `ErrorMessage` string, required: Contains a description of the error if the request failed
  - `Token` string, required: Bank account token
  - `IsDefault` boolean, required: Is this the VoPay account holder's default bank account

---

[API](https://skmtc.dev/vopay/apis/payment-methods.md) - [All operations](https://skmtc.dev/vopay/apis/payment-methods/llms.txt) - [OpenAPI document](https://skmtc.dev/vopay/apis/payment-methods/revisions/b566c8002410?raw)
