Receive events by webhook

Missed call, text received, voicemail: your server is notified.

Role : ManagerDuration : 3 minOn : Web

On this page

Before you start

Be a manager on the Callizy account.
A public https address that receives POST requests: your server, or a tool like Make.

5 steps, about 3 min

1
Open the Webhooks tab
10 s
In Developers, Webhooks tab, click New webhook.
Administration/Settings/Developers/Webhooks
Open this screen in Callizy
2
Name and address
30 s
Name: what it is for, for example “Missed calls”. Destination URL: the address that will receive the events.
3
Pick the events
30 s
Under Events to listen for, check what you need among 17: Missed call, Voicemail received, SMS received, Summary ready, Appointment booked… Then Create: “Webhook created.”
4
Test
20 s
On the webhook card, click Test. The result shows below, for example “Your endpoint answered HTTP 200: test received.”
5
Check the signature
1 min
Each delivery carries the X-Callizy-Signature header: an HMAC-SHA256 of the raw body, computed with the card’s Signing secret. Click Reveal to see it and copy it, at any time.

17 events: calls, voicemails, texts, contacts, appointments and tasks.
A failed delivery is retried for nearly three days; after 5 days of failures, the webhook is paused.
The Zaps that listen to Callizy also show up in this tab.

Callizy shows “Invalid URL”

Callizy shows “Pick at least one event”

Callizy shows “Your endpoint answered HTTP 401: it refused the test”

Your endpoint requires an Authorization header: accept requests without one, Callizy signs each one with X-Callizy-Signature.

Callizy shows “Your endpoint didn’t answer within 10 seconds”

Callizy shows “This address can’t receive webhooks: it isn’t public”

Use an address reachable from the Internet: not localhost, and not an internal network address.

The card shows recent failures

Click Test to see your endpoint’s response.
After 24 h of failures, managers get an email; after 5 days, the webhook is paused: fix the address, then click Activate.