Guidesllms.txt
Webhooks
We tell your servers when anything changes, so you never have to poll.
Add an endpoint in the dashboard or with the API. Each event carries the full object, so you rarely need a second request.
| Event | When |
|---|---|
verification.completed | Checks finished, with ready_to_pay |
estimate.updated | What a customer owes changed |
balance.short | Savings won’t cover the quarter |
payment.scheduled | A payment is booked |
payment.settled | The agency has the money |
payment.returned | A payment bounced, with the reason |
return.drafted | A draft return is ready (beta) |
Check the signature
Every request carries a WorkMade-Signature header. Recompute it with your endpoint’s secret and reject anything that doesn’t match or is more than five minutes old.
import crypto from "node:crypto" // header looks like: t=1767225600,v1=5257a869e7ec... export function verify(rawBody, header, secret) { const { t, v1 } = Object.fromEntries(header.split(",").map(p => p.split("="))) if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false const expected = crypto.createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex") return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(v1)) }
Reply with any 2xx within 10 seconds. If you don’t, we retry with backoff for three days. Events can arrive out of order, so use the object’s status, not the order you received them in.
Was this page helpful?