Webhooks
Add an endpoint with POST /v1/webhook-endpoints: an https address on the open internet and the events you want. SYNC answers with the endpoint’s signing secret, once. A platform’s endpoints get events from every business connected to it; a business’s own endpoints get its own.
Events
connection.activatedconnection.disconnectedevent.postedevent.needs_reviewevent.failedjournal_entry.postedjournal_entry.reversedperiod.closedbank_account.feed_stalebank_transaction.needs_reviewimport.ready_to_promoteimport.promotedimport.reversedtax_return.offeredtax_return.withdrawn
What arrives
POST https://yourapp.example/sync/webhooks
Vortex-Signature: t=1763000000,v1=5f2b...
Content-Type: application/json
{
"id": "evt_...",
"type": "event.posted",
"entity_id": "6f1c...e2",
"connection_id": "9a0d...41",
"created_at": "2026-11-13T20:00:00.000Z",
"data": { "object": { ... } }
}data.object is the thing as it stood then: the connection, the event or the journal entry. Use id to ignore a delivery you’ve already handled.
Checking the signature
Vortex-Signature is t= the Unix time it was sent and v1= the hex HMAC-SHA256 of "<t>.<body>" with your secret. Check it against the raw body, and refuse anything older than five minutes:
import { createHmac, timingSafeEqual } from 'node:crypto';
function verify(secret, rawBody, header) {
const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')));
const t = Number(parts.t);
if (!Number.isInteger(t) || Math.abs(Date.now() / 1000 - t) > 300) return false;
const expected = createHmac('sha256', secret).update(`${t}.${rawBody}`).digest();
const given = Buffer.from(parts.v1 ?? '', 'hex');
return given.length === expected.length && timingSafeEqual(given, expected);
}Retries
Answer with any 2xx within ten seconds. Anything else is tried again after 1 minute, 5 minutes, 30 minutes, 2 hours, 6 hours, 12 hours, then daily, for up to three days. SYNC never follows a redirect.

