Webhooks integration

Every sync POSTs signed JSON to your HTTPS endpoint: transactions, balances, holdings and trades from 12k+ banks, verified with your own signing secret.

POST api.yourapp.com/webhooks/banksync200 OK · 142 ms
webhook-id:        evt_job-7q2_0_1_1webhook-timestamp: 1792501320webhook-signature: v1,K5oZfzN95Z9UVu1EsfQmfVNQhnkZ2pj9o9NDN/H/pI4=content-type:      application/json {  "id": "evt_job-7q2_0_1_1",  "type": "transactions.delta",  "apiVersion": "2026-06-01",  "createdAt": "2026-10-20T13:02:00.000Z",  "feed": { "id": "feed_9d1", "name": "Chase to Webhook", "dataType": "transactions" },  "job": { "id": "job_7q2", "trigger": "scheduled" },  "batch": { "sequence": 1 },  "data": [    { "id": "10a4d071832649a", "date": "2026-10-19", "amount": 4200.00, … },    { "id": "4bdd8e6931727cd", "date": "2026-10-19", "amount": -86.42, … },    …1 more  ]}
One transactions.delta delivery from Chase Checking and Amex Gold, signed with your whsec_ secret in the Standard Webhooks format.

From bank to your server in three steps.

  1. 01

    Connect an endpoint

    Paste a public HTTPS URL. BankSync shows a whsec_ signing secret once, and sends a test event.

    URLhttps://api.yourapp.com/…
    Secretwhsec_••••••••••••
    Test event● 200 in 142ms
  2. 02

    Point a feed at it

    Pick accounts and a data type. There is nothing to map: you get a versioned JSON envelope.

    TransactionsBalancesHoldingsTradesLoans
    Eventtransactions.delta
    MappingNone, a payload preview
  3. 03

    Verify every delivery

    Check the signature with any Standard Webhooks library, then upsert rows by id.

    server.js

    import { Webhook } from 'standardwebhooks'const wh = new Webhook(secret)const event = wh.verify(body, headers)// de-dupe on event.id

Webhooks, set up start to finish.

Setting up Webhooks in BankSync, filmed with sample accounts.

What lands at your endpoint.

id
Unique per delivery and stable across retries. Your idempotency key, the same as the webhook-id header.
type
transactions.delta for new or changed transactions; balances, holdings, trades, orders and loans arrive as *.snapshot.
apiVersion
The date-pinned payload contract, currently 2026-06-01.
feed
The id, name and data type of the feed that sent it.
job
The run it belongs to, and what started it: scheduled, manual, api, test or redelivery.
batch
The batch’s place in the run, so you can order them.
data
The rows. Transactions carry id, date, description, signed amount, currency, category, pending and the account.
Field tables for every data type and verification code in several languages are in the webhook reference.

The same data can also go to spreadsheets, workspaces, AI assistants and your own code.

Webhooks, in short.

Data
Transactions, balances, holdings, trades, orders and loans, one data type per feed.
Signing
Standard Webhooks: HMAC-SHA256 over the id, timestamp and body. Rotating the secret keeps the old one valid for 24 hours.
Delivery
At least once. 408, 425, 429, 5xx and timeouts are retried with backoff; 410 disables the endpoint.
Endpoints
Public HTTPS only. Private, loopback and internal addresses are rejected.
Schedule
Choose hourly, daily, or weekly automatic syncs based on your plan, or run a manual sync at any time.
Plan
Standard plan or higher, alongside the API and MCP.
Setup
About 5 minutes. Send signed JSON to your own endpoint; no third-party cost.
Status
Available today.

Questions, answered.

How do I verify a BankSync webhook?

Every delivery carries webhook-id, webhook-timestamp and webhook-signature headers in the Standard Webhooks format. Verify them with your whsec_ secret using any Standard Webhooks library, and reject timestamps more than 5 minutes old.

What happens if my endpoint is down?

Delivery is at least once. 408, 425, 429, 5xx responses and timeouts are retried with exponential backoff under the same id, so de-duplicate on id. A 410 response disables the endpoint.

Which events does BankSync send?

transactions.delta for new or changed transactions; balances.snapshot, holdings.snapshot, trades.snapshot, orders.snapshot and loans.snapshot for current state; sync.completed or sync.failed at the end of each run; and endpoint.test for test events.

Can I send webhooks to localhost or a private network?

No. Endpoints must be public https:// URLs. Addresses that resolve to private, loopback, link-local or internal ranges are rejected when you save them.

Which plan includes webhooks?

Webhooks come with the Standard plan and above, alongside the API and MCP.

Bank data at your endpoint.

BankSync is not affiliated with, endorsed by, or an official partner of Webhooks. Webhooks trademarks belong to their respective owners.