Webhooks API

Manage webhook subscriptions programmatically. Register URLs to receive event notifications.

Endpoints

GET
/tenants/{tenantId}/webhooks

List all webhook subscriptions

POST
/tenants/{tenantId}/webhooks

Create a webhook subscription

GET
/tenants/{tenantId}/webhooks/{webhookId}

Get a single webhook

DELETE
/tenants/{tenantId}/webhooks/{webhookId}

Delete a webhook subscription

POST
/tenants/{tenantId}/webhooks/{webhookId}/test

Send a test event to a webhook

Create Webhook

Requestbash
curl -X POST \
  "https://your-domain.booqr.nl/api/v1/tenants/{tenantId}/webhooks" \
  -H "Authorization: Bearer booqr_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhooks/booqr",
    "events": ["booking.created", "booking.confirmed", "booking.cancelled"],
    "secret": "whsec_your_signing_secret"
  }'
Response 201json
{
  "webhook": {
    "id": "webhook-uuid",
    "url": "https://your-app.com/webhooks/booqr",
    "events": ["booking.created", "booking.confirmed", "booking.cancelled"],
    "active": true,
    "createdAt": "2026-02-16T12:00:00Z"
  }
}