Create bank accountBeta

POST

/v2/bank-accounts

Store a bank account on file for a square account

Permissions:BANK_ACCOUNTS_WRITE

Guide

Create a bank account

Try in API Explorer

Link to section

Request body

Example code

Link to section

idempotency_key

string

Required

Unique ID. For more information, see the Idempotency.

Link to section

source_id

string

Required

The ID of the source that represents the bank account information to be stored. This field accepts the payment token created by WebSDK

Link to section

customer_id

string

The ID of the customer associated with the bank account to be stored.

Link to section

Response fields

Link to section

bank_account

The 'BankAccount' that was created.

Link to section

errors

Information on errors encountered during the request.

Link to section

Examples

All versions ->

POST /v2/bank-accounts

curl https://connect.squareup.com/v2/bank-accounts \
  -X POST \
  -H 'Square-Version: 2026-01-22' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "idempotency_key": "4e43559a-f0fd-47d3-9da2-7ea1f97d94be",
    "source_id": "bnon:CA4SEHsQwr0rx6DbWLD5BQaqMnoYAQ",
    "customer_id": "HM3B2D5JKGZ69359BTEHXM2V8M"
  }'

Response JSON

{
  "bank_account": {
    "id": "bact:OxfBTiXgByaXds1K4GB",
    "account_number_suffix": "000",
    "country": "US",
    "currency": "USD",
    "account_type": "CHECKING",
    "holder_name": "Nicola Snow",
    "primary_bank_identification_number": "011401533",
    "status": "VERIFIED",
    "creditable": true,
    "debitable": true,
    "fingerprint": "sq-1-mO3XNctJpTLL8uYowOWpioS8nQyTc838gcBo90254XonoEJ_c7Uw6yqL6qihFNY8fA",
    "version": 2,
    "bank_name": "Citizens Bank",
    "customer_id": "HM3B2D5JKGZ69359BTEHXM2V8M"
  }
}