Skip to main content
WorkMadeDocs2026-11-01 · Preview
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.

EventWhen
verification.completedChecks finished, with ready_to_pay
estimate.updatedWhat a customer owes changed
balance.shortSavings won’t cover the quarter
payment.scheduledA payment is booked
payment.settledThe agency has the money
payment.returnedA payment bounced, with the reason
return.draftedA 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.

verify.js
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?