Setting up webhooks
Webhooks let Anghello automatically send notifications to your applications when an event occurs (a visitor arrives, leaves, and so on). This guide shows you how to create and manage them.
Audience: Administrators
Application: Admin (app.anghello.co)
Estimated time: 10 minutes
Before you start
- You need an Administrator account on Anghello
- The "API & Webhooks" add-on must be included in your subscription
- You need a receiving URL (HTTPS endpoint) in your application
Creating a webhook
1. Open the Webhooks page
In the left-hand menu, click the box showing your first name at the very bottom, then click API Keys. Finally, click the Webhooks tab.
2. Add a webhook
Click the Add a webhook button.
3. Configure the webhook
Field | Required | Description |
|---|---|---|
Endpoint URL | Yes | The HTTPS address that will receive the data (must start with |
Description | No | Free text describing what this webhook is used for |
Site | No | If selected, the webhook only fires for that site's events. Otherwise, it fires for all sites. |
Events | Yes | The event types that trigger the webhook (see below) |
4. Save
Click Save. A window shows the webhook secret (be sure to keep it), which becomes active immediately.
Available events
Select one or more events from:
- Visitor checked in — A visitor has just checked in
- Visitor checked out — A visitor has checked out
- Visit pre-registered — A visit has been scheduled
- Visit cancelled — A pre-registered visit has been cancelled
Viewing a webhook's details
Click a webhook in the list to see:
- The endpoint URL
- The secret key (used to verify the authenticity of requests)
- The delivery history (successes, failures)
Enabling or disabling a webhook
You can temporarily disable a webhook without deleting it:
1. Open the webhook concerned.
2. Edit the webhook by clicking the pencil icon.
3. Toggle Enable Webhook off or on.
4. Save.
Limits
Limit | Value |
|---|---|
Maximum number of webhooks | 5 per organization |
Maximum per event | 3 webhooks per event type |
Good to know
💡 Tip: Each webhook gets a unique secret key. Use it to verify that requests really come from Anghello.
💡 Tip: If your endpoint is temporarily unavailable, failed webhooks appear in the delivery history. Anghello does not automatically retry failed deliveries.
Troubleshooting
Problem | Solution |
|---|---|
The Webhooks page doesn't appear | The "API & Webhooks" add-on isn't included in your subscription. Contact our team. |
The webhook doesn't fire | Check that the webhook is active and that the event is selected. Review the delivery history. |
The endpoint returns an error | Check that your server is reachable and that the URL is correct. Errors appear in the history. |
The webhook limit is reached | Delete an existing webhook or disable the ones you no longer use. |
If the problem persists, contact our team via the chat at the bottom right of your screen, or at support@anghello.co.
Updated on: 23/07/2026
Thank you!