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.
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 ]}
From bank to your server in three steps.
- 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 - 02
Point a feed at it
Pick accounts and a data type. There is nothing to map: you get a versioned JSON envelope.
TransactionsBalancesHoldingsTradesLoansEventtransactions.deltaMappingNone, a payload preview - 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.
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.
