API ReferenceSlotflow APIWebhooks

Register a webhook

Register a URL to receive webhook notifications for booking events. Slotflow will POST event payloads to your URL whenever a matching event occurs. **Supported events:** - `booking.confirmed` — a new booking was created - `booking.cancelled` — a booking was cancelled Duplicate URLs (same organization, same active URL) are rejected. The number of webhooks you can register depends on your plan.

Authentication

AuthorizationBearer
API key authentication. Pass your key as a Bearer token: ``` Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx ``` Get your API key from the [Slotflow Dashboard](https://app.slotflow.dev).

Request

This endpoint expects an object.
urlstringRequiredformat: "uri"

URL to receive webhook POST requests (must be HTTPS in production)

eventslist of enumsRequired
Events to subscribe to
Allowed values:

Response

Webhook registered
idstring or nullformat: "uuid"
urlstring or nullformat: "uri"
URL that receives webhook POST requests
eventslist of enums or null
Events this webhook subscribes to
Allowed values:
activeboolean or null
created_atdatetime or null

Errors