Webhooks: Getting Notified the Moment Something Happens
Pushing events to your own endpoint in real time, instead of polling the API.
What this is
A webhook sends an HTTP POST to a URL you choose the moment something happens in your CRM — a contact created, a deal won, an invoice paid. Find it under Settings → Webhooks.
Webhooks vs. the API
The public API is for asking. A webhook is for being told. If you need to react to something the instant it happens — send a Slack message the moment a deal is won, push a paid invoice into your accounting tool — a webhook gets there faster and cheaper than polling ever will.
Available events
Contact created, company created, lead created, deal won, deal lost, task completed, invoice paid online.
Setting one up
- Go to Settings → Webhooks.
- Enter the URL on your side that should receive the POST.
- Tick which events you want.
- Save — you'll be shown a signing secret once. Store it; it isn't shown again.
Verifying a webhook is really from us
Every request carries an `X-Allsorts-Signature` header — an HMAC-SHA256 of the request body, signed with your secret. Recompute it on your end and compare before trusting the payload; anyone could otherwise POST a fake event to your endpoint.
Delivery
Best-effort, fire-and-forget. A slow or broken endpoint on your side never blocks or delays the action that triggered it in the CRM — your contact still gets created even if your webhook receiver is down.