Webhooks API - DailyBot Developers

DailyBot API endpoints for creating and managing outgoing webhook subscriptions for real-time event notifications.

Webhooks API

Webhooks allow your application to receive real-time notifications when events occur in DailyBot. Instead of polling the API, you register a URL that DailyBot will call whenever subscribed events happen.

Info

For a comprehensive guide on webhooks including event types, payload formats, and best practices, see the WebHooks & Events guide.

Create Webhook Subscription

POST /v1/webhook-subscription/

Creates an outgoing webhook subscription for event notifications. Events matching your subscriptions will be sent as HTTP POST requests to your URL.

Body Parameters

Name Type Required Description
hook_url string Required The URL that will receive webhook event payloads.
name string Optional A human-readable name for the webhook subscription.
subscriptions array Optional Array of event types to subscribe to (e.g. "checkin.response.created").
subscribed_objects array Optional Array of specific check-in or form UUIDs to filter events.
bearer string Optional Authentication token sent in webhook request headers for verification.
immediate_sample_event boolean Optional Send a sample event immediately after creation for testing.
Request 
curl -X POST "https://api.dailybot.com/v1/webhook-subscription/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "hook_url": "https://your-app.com/webhooks/dailybot",
    "name": "Check-in Responses",
    "subscriptions": ["checkin.response.created"],
    "bearer": "your-verification-token",
    "immediate_sample_event": true
  }'
Response 201 Created
json 
{
  "hook_id": "wh-1234-abcd",
  "hook_url": "https://your-app.com/webhooks/dailybot",
  "name": "Check-in Responses",
  "subscriptions": [
    "checkin.response.created"
  ],
  "created_at": "2026-02-14T12:00:00Z"
}

Verify Webhook Signatures

Use the bearer parameter to set a verification token. DailyBot will include this token in the Authorization header of webhook requests so your server can verify the request origin.

Delete Webhook Subscription

DELETE /v1/webhook-subscription/

Removes a webhook subscription. Both the hook ID and URL are required for confirmation.

Query Parameters

Name Type Required Description
hook_id string Required The ID of the webhook subscription to delete.
hook_url string Required The URL of the webhook subscription to delete.
Request 
curl -X DELETE "https://api.dailybot.com/v1/webhook-subscription/?hook_id=wh-1234-abcd&hook_url=https://your-app.com/webhooks/dailybot" \
  -H "X-API-KEY: your_api_key"
Response 204 No Content
json