Development
  • Guides
  • API Reference
  • API Explorer
  • SDKs
  • Sample apps
  • System status
Support
  • Developer forums
  • Developer blog
  • YouTube
  • X
More
  • Square Home
  • Square Developer
  • App Marketplace
  • Partner with Square
  • Solutions Partner Program
  • Pricing
  • Sales

© 2026 Square, Inc.

  • Developer terms of service
  • Developer Integration and Marketing Agreement
  • Privacy policy
  • Partnerships
  • Sign In
  • Sign In

    Bank Accounts

  • List bank accounts

  • Create bank account

  • Get bank account by v1Id

  • Get bank account

  • Disable bank account

  • Webhooks

  • bank_account.created

  • bank_account.disabled

  • bank_account.verified

<- Bank Accounts webhooks

Bank Accounts webhooks

All versions ->

bank_account created

EVENT

 bank_account.created

Published when you link an external bank account to a Square account in the Seller Dashboard. Square sets the initial status to VERIFICATION_IN_PROGRESS and publishes the event.

Permissions:BANK_ACCOUNTS_READ
Link to section

Event payload

Example code

Link to section

merchant_id

string

The ID of the target merchant associated with the event.

Link to section

location_id

string

The ID of the target location associated with the event.

Link to section

type

string

The type of event this represents, "bank_account.created".

Link to section

event_id

string

A unique ID for the event.

Link to section

created_at

string

Read only Timestamp of when the event was created, in RFC 3339 format.

Examples for January 25th, 2020 6:25:34pm Pacific Standard Time:

UTC: 2020-01-26T02:25:34Z

Pacific Standard Time with UTC offset: 2020-01-25T18:25:34-08:00

Link to section

data

Data associated with the event.

Link to section

Examples

All versions ->

Response JSON

{ "merchant_id": "6SSW7HV8K2ST5", "location_id": "S8GWD5DBJ3HF3", "type": "bank_account.created", "event_id": "d214f854-adb1-4f56-b078-4b8697a3187a", "created_at": "2020-02-15T04:38:13Z", "data": { "type": "bank_account", "id": "bact:cgvL1yv43VFjexample", "object": { "bank_account": { "id": "bact:cgvL1yv43VFjexample", "account_number_suffix": "526", "country": "US", "currency": "USD", "account_type": "CHECKING", "holder_name": "John Doe", "primary_bank_identification_number": "101211111", "location_id": "S8GWD5DBJ3HF3", "status": "VERIFICATION_IN_PROGRESS", "creditable": true, "debitable": true, "version": 1, "bank_name": "Bank Name" } } } }