Docs/Webhooks
API Reference
Webhooks

Webhooks Reference

Use webhooks to automate booking lifecycle events in downstream systems like CRMs, Slack channels, and analytical pipelines.

Direct answer

What are booking webhooks?

Booking webhooks are HTTP notifications sent when scheduling events happen, such as a booking being created, rescheduled, or cancelled. Semiora webhooks let teams update CRMs, send internal alerts, sync analytics, and automate downstream systems after booking lifecycle changes.

Supported events

  • booking.created — Fired when a new slot is confirmed.
  • booking.cancelled — Fired when a meeting is removed by host or guest.
  • booking.rescheduled — Fired when slot timing changes.

Payload Envelope

{
  "event": "booking.created",
  "id": "evt_123",
  "occurred_at": "2026-04-22T12:34:56Z",
  "booking": { "id": "b_456", "start": "2026-04-25T14:00:00Z", "end": "2026-04-25T14:30:00Z" }
}

Operational Best Practices

  • Verify payload signatures using your workspace shared secret.
  • Enforce idempotency rules by tracking the webhook id.
  • Use backoff timers to retry failed message deliveries automatically.

Frequently asked questions

What are booking webhooks?

Booking webhooks are HTTP notifications sent when scheduling events happen, such as a booking being created, rescheduled, or cancelled. Semiora webhooks help teams update CRMs, notify internal systems, and automate operations after booking changes.

Which booking lifecycle events does Semiora support?

Semiora webhook events include booking.created, booking.rescheduled, and booking.cancelled. Each event includes a payload envelope with an event ID, occurrence timestamp, and booking details.

How should webhook retries be handled?

Use the webhook event ID for idempotency, verify signatures with the workspace secret, and retry failed processing with backoff so downstream systems do not create duplicate records.

Implementation guide

New to webhook reliability patterns?

Read the practical primer for signature checks, idempotency, retries, and dead-letter queues before you connect production systems.

Read Webhooks 101

Automation guides

Connect webhooks to booking workflows

Use these guides to decide which booking events to send downstream and how to keep delivery reliable.

Glossary

Related webhook definitions

Use these definitions to connect booking lifecycle events to scheduling and intake concepts.