Source
Integrations, API & data export — found from sitemap — Cal.com
Checked for Cal.com on 28 Oct 2026
- Page
- https://cal.com/docs/api-reference/v2/webhooks/create-a-webhook
- Checked
- 28 Oct 2026, 13:35 UTC
- How we may use it
- Public page, crawling permitted
Technical details
- type
- page
- http status
- 200
- content hash
- sha256:9f9ac3a4519db3de2339e399609b106e9f0decd7c10c7ff75683c886748ee00f
- permission
- robots_ok
- screenshot
- Screenshot on file (internal exhibit, not published)
Cited by
Facts read from this source
-
Webhook create endpoint Report an error
“POST / v2 / webhooks”
-
Webhook oauth scope Report an error
“If accessed using an OAuth access token, the WEBHOOK_WRITE scope is required.”
-
Webhook auth Report an error
“value must be Bearer <token> where <token> is api key prefixed with cal_”
-
Webhook triggers Report an error
“Available options: BOOKING_CREATED, BOOKING_PAYMENT_INITIATED, BOOKING_PAID, BOOKING_RESCHEDULED, BOOKING_REQUESTED, BOOKING_CANCELLED, BOOKING_REJECTED, BOOKING_SEAT_REJECTED, BOOKING_NO_SHOW_UPDATED, BOOKING_LOCATION_UPDATED, BOOKING_TITLE_UPDATED, BOOKING_REASSIGNED, BOOKING_SEAT_ACCEPTED, FORM_SUBMITTED, MEETING_ENDED, MEETING_STARTED, RECORDING_READY, INSTANT_MEETING, INSTANT_MEETING_ACCEPTED, RECORDING_TRANSCRIPTION_GENERATED, OOO_CREATED, AFTER_HOSTS_CAL_VIDEO_NO_SHOW, AFTER_GUESTS_CAL_VIDEO_NO_SHOW, FORM_SUBMITTED_NO_EVENT, ROUTING_FORM_FALLBACK_HIT, DELEGATION_CREDENTIAL_ERROR, WRONG_ASSIGNMENT_REPORT, DELEGATION_CREDENTIAL_SECRET_ROTATION_FAILED, DELEGATION_CREDENTIAL_ROTATION_REQUIRED, DELEGATION_CREDENTIAL_SECRET_ROTATED, CALENDAR_ENTRY_REJECTED”
-
Webhook custom headers Report an error
“Static HTTP headers sent on every webhook delivery (e.g. Authorization). Max 10 headers, values up to 4 KiB, stored encrypted and redacted on read.”
-
Webhook header keyring requirement Report an error
“An instance without the webhook header keyring (CALCOM_KEYRING_WEBHOOK_HEADERS) answers 400 to any request that sends headers.”
-
Webhook reserved header names Report an error
“Names starting with X-Cal- are reserved for Cal.com's own headers. Blocked names: host, content-length, transfer-encoding, connection, keep-alive, upgrade, trailer, te, proxy-authorization.”
-
Webhook versions Report an error
“Available options: 2021-10-20, 2026-07-27”
-
Webhook version 2026 ics Report an error
“Version 2026-07-27 adds generated ICS calendar content (attendeeIcsContent, organizerIcsContent) to BOOKING_CREATED, BOOKING_RESCHEDULED, BOOKING_CANCELLED, BOOKING_SEAT_ACCEPTED, and BOOKING_PAID (when the payment accepted the booking) payloads.”
-
Webhook no show timing Report an error
“How long after the booking start time the no-show triggers are evaluated. Required, together with timeUnit, when subscribing to AFTER_HOSTS_CAL_VIDEO_NO_SHOW or AFTER_GUESTS_CAL_VIDEO_NO_SHOW Required range: x >= 1”
-
Webhook other endpoints Report an error
“POST Create a webhook GET Get all webhooks PATCH Update a webhook GET Get a webhook DEL Delete a webhook”
Scores citing this record
- The Independent Consultant Integrations, API & data export
- The Data Protection Officer Integrations, API & data export
- The Practice Owner Integrations, API & data export
- The Sales Team Lead Team, staff & location scheduling
- The Sales Team Lead Reminders, payments & no-show protection
- The Sales Team Lead Integrations, API & data export
- The Salon Owner Booking page & client experience
- The Salon Owner Reminders, payments & no-show protection
- The Salon Owner Integrations, API & data export
- The Skeptic Reminders, payments & no-show protection
- The Skeptic Integrations, API & data export