> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thetinybell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Receive real-time event notifications from TinyBell.

## Overview

Webhooks allow your systems to receive real-time notifications when events occur in TinyBell. Configure a webhook URL in your property settings, and TinyBell will send HTTP POST requests to that URL when events fire.

## Configuration

1. Go to your property settings.
2. Enter your webhook URL.
3. Select which events to receive.
4. Save.

## Webhook payload

```json theme={null}
{
  "event": "notification.click",
  "timestamp": "2026-04-04T14:30:00Z",
  "property_id": 7,
  "notification_id": 42,
  "data": {
    "url": "https://www.myhotel.com/rooms",
    "device_type": "desktop",
    "country_code": "ES",
    "visitor_id": "v_abc123def456"
  }
}
```

## Available events

| Event                     | Description                            |
| ------------------------- | -------------------------------------- |
| `notification.impression` | A notification was shown               |
| `notification.click`      | A visitor clicked the CTA              |
| `notification.close`      | A visitor dismissed the notification   |
| `notification.conversion` | A form was submitted (collector types) |

## Retry policy

If your endpoint returns a non-2xx status code, TinyBell retries the request:

* 1st retry: after 30 seconds
* 2nd retry: after 5 minutes
* 3rd retry: after 30 minutes

After 3 failed attempts, the webhook is marked as failed. You can manually retry from the dashboard.

## Security

Webhook requests include a signature header for verification:

```
X-TinyBell-Signature: sha256=HMAC_HASH
```

Verify the signature using your webhook secret (available in property settings) to confirm the request came from TinyBell.

## Use cases

* **Sync clicks to your CRM**: Forward notification clicks to your PMS or CRM.
* **Trigger email sequences**: When a visitor submits their email via a collector notification, trigger a welcome email from your email tool.
* **Real-time alerts**: Get notified when conversion spikes or drops.