The Bookable webhook system delivers real-time notifications to your endpoint when booking events occur, a venue operator messages you, or a venue you distribute closes.
There are two API specifications in this section:
- Register Webhook Events — endpoints for managing your webhook subscriptions (
/webhooks/subscriptions: list, create, update or pause, delete, rotate a secret) and for sending a test event to them (POST /webhooks/test). A distributor can hold several subscriptions, each with its own callback URL, secret and event filter. - Handling Webhook Events — the specification your callback endpoint must implement to receive and acknowledge incoming event payloads (
booking.updated,message.received,venue.updated,webhook.ping).
Webhooks are available in both production and sandbox. POST /webhooks/test sends a webhook.ping in production; in sandbox it can also send sample, real or simulated business events, and any booking you create, amend, or cancel there notifies your own callback URL.
For integration guidance, setup steps, sandbox testing, and HMAC signature verification examples, see the Webhook Guide.