Skip to main content

​
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

{
  "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

EventDescription
notification.impressionA notification was shown
notification.clickA visitor clicked the CTA
notification.closeA visitor dismissed the notification
notification.conversionA 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.