cURL
Webhooks
Create Webhook
Register a Novacal webhook to receive real-time notifications when events are booked, rescheduled, or canceled, with a signing secret to verify deliveries.
POST
cURL
What this endpoint is for
Register a URL that Novacal calls whenever something happens to an event you host or organize. Webhooks let you react to bookings in real time instead of polling the events endpoint.Available events
Subscribe to one or more events per webhook. You can register several webhooks pointing at different URLs.
Delivery format
Novacal sends aPOST request with a JSON body:
data object is the same event payload returned by the Get Event endpoint.
Verifying deliveries
Every delivery carries two headers:
Recompute the signature over the raw body and compare it before trusting a request:
Retries
Respond with a2xx status code to acknowledge a delivery. Novacal retries a failed delivery up to three times with a short backoff, so your endpoint should be idempotent.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Webhook payload
The HTTPS URL that Novacal sends deliveries to
Example:
"https://example.com/hooks/novacal"
The events to subscribe to. At least one is required.
Minimum array length:
1Available options:
event.created, event.rescheduled, event.canceled Example:
Whether the webhook starts active. Defaults to true.
Example:
true