> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.anghello.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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.

![](https://storage.crisp.chat/users/helpdesk/website/-/2/0/a/6/20a671ba57d61a00/screenshot15xpostspark2026-03-_6da8vv.png)

**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 `https://`)                                       |
| **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)                                                           |

![](https://storage.crisp.chat/users/helpdesk/website/-/2/0/a/6/20a671ba57d61a00/screenshot15xpostspark2026-03-_prw4if.png)

**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.

|| **Important:** The endpoint URL must use the **HTTPS** protocol. HTTP URLs are not accepted.

## 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.