Skip to content

Scheduling infrastructure for absolutely everyone.

docs: add automatic no show updated docs (#25507)

Udit Takkarcbcd769f882a
diff --git a/docs/developing/guides/automation/webhooks.mdx b/docs/developing/guides/automation/webhooks.mdx
index f53b6b0acac..8cd6c6876f1 100644
--- a/docs/developing/guides/automation/webhooks.mdx
+++ b/docs/developing/guides/automation/webhooks.mdx
@@ -34,6 +34,9 @@ To create a new webhook subscription, visit `/settings/developer/webhooks` and p
- `Form Submitted`
- `Meeting Ended`
- `Instant Meeting Created`
+ - `Booking No-show Updated`
+ - `After Hosts Didn't Join Cal Video`
+ - `After Guests Didn't Join Cal Video`
</Step>
<Step title="Secret">
You can provide a secret key with this webhook to [verify it](/docs/core-features/webhooks#verifying-the-authenticity-of-the-received-payload) on the subscriber URL when receiving a payload. This helps confirm whether the payload is authentic or has been tampered with. You can leave it blank if you don't wish to secure the webhook with a secret key.
@@ -144,6 +147,155 @@ To create a new webhook subscription, visit `/settings/developer/webhooks` and p
```
+### Booking No-show Updated webhook payload
+
+This webhook is triggered when an attendee is manually marked or unmarked as no-show on the `/bookings/past` page.
+
+**Example payload when marking an attendee as no-show:**
+
+```json
+{
+ "triggerEvent": "BOOKING_NO_SHOW_UPDATED",
+ "createdAt": "2025-12-01T12:34:34.774Z",
+ "payload": {
+ "message": "[email protected] marked as no-show",
+ "attendees": [
+ {
+ "email": "[email protected]",
+ "noShow": true
+ }
+ ],
+ "bookingUid": "5vQFqxDFMjdgKGMijqtqRw",
+ "bookingId": 31
+ }
+}
+```
+
+**Example payload when unmarking an attendee as no-show:**
+
+```json
+{
+ "triggerEvent": "BOOKING_NO_SHOW_UPDATED",
+ "createdAt": "2025-12-01T12:38:31.663Z",
+ "payload": {
+ "message": "[email protected] unmarked as no-show",
+ "attendees": [
+ {
+ "email": "[email protected]",
+ "noShow": false
+ }
+ ],
+ "bookingUid": "5vQFqxDFMjdgKGMijqtqRw",
+ "bookingId": 31
+ }
+}
+```
+
+### Cal Video No-Show Detection webhooks
+
+These webhooks are triggered **automatically** when hosts or guests don't join a Cal Video meeting within the configured time after the booking starts. Unlike `BOOKING_NO_SHOW_UPDATED` which requires manual action, these are detected automatically by checking Cal Video participant data.
+
+<Note>
+These webhooks only work for bookings that use Cal Video as the meeting location.
+</Note>
+
+**Example payload when host didn't join (`AFTER_HOSTS_CAL_VIDEO_NO_SHOW`):**
+
+```json
+{
+ "triggerEvent": "AFTER_HOSTS_CAL_VIDEO_NO_SHOW",
+ "createdAt": "2025-12-01T15:23:30.320Z",
+ "payload": {
+ "title": "30min between Owner 1 and test",
+ "bookingId": 32,
+ "bookingUid": "qVyXscm1ryg2QoQ4K8uHLW",
+ "startTime": "2025-12-02T04:00:00.000Z",
+ "attendees": [
+ {
+ "id": 32,
+ "email": "[email protected]",
+ "name": "test",
+ "timeZone": "Asia/Kolkata",
+ "phoneNumber": null,
+ "locale": "en",
+ "bookingId": 32,
+ "noShow": false
+ }
+ ],
+ "endTime": "2025-12-02T04:30:00.000Z",
+ "participants": [],
+ "hostEmail": "[email protected]",
+ "eventType": {
+ "id": 50,
+ "teamId": null,
+ "parentId": null,
+ "calVideoSettings": null
+ },
+ "webhook": {
+ "id": "2bdfc20b-aa4a-4863-a499-932cb1d4e69a",
+ "subscriberUrl": "https://webhook.site/example",
+ "appId": null,
+ "time": 5,
+ "timeUnit": "MINUTE",
+ "eventTriggers": [
+ "AFTER_HOSTS_CAL_VIDEO_NO_SHOW",
+ "AFTER_GUESTS_CAL_VIDEO_NO_SHOW"
+ ],
+ "payloadTemplate": null
+ },
+ "message": "Host with email [email protected] didn't join the call or didn't join before 2025-12-02 04:05:00 +00:00"
+ }
+}
+```
+
+**Example payload when guest didn't join (`AFTER_GUESTS_CAL_VIDEO_NO_SHOW`):**
+
+```json
+{
+ "triggerEvent": "AFTER_GUESTS_CAL_VIDEO_NO_SHOW",
+ "createdAt": "2025-12-01T15:23:30.323Z",
+ "payload": {
+ "title": "30min between Owner 1 and test",
+ "bookingId": 32,
+ "bookingUid": "qVyXscm1ryg2QoQ4K8uHLW",
+ "startTime": "2025-12-02T04:00:00.000Z",
+ "attendees": [
+ {
+ "id": 32,
+ "email": "[email protected]",
+ "name": "test",
+ "timeZone": "Asia/Kolkata",
+ "phoneNumber": null,
+ "locale": "en",
+ "bookingId": 32,
+ "noShow": false
+ }
+ ],
+ "endTime": "2025-12-02T04:30:00.000Z",
+ "participants": [],
+ "eventType": {
+ "id": 50,
+ "teamId": null,
+ "parentId": null,
+ "calVideoSettings": null
+ },
+ "webhook": {
+ "id": "2bdfc20b-aa4a-4863-a499-932cb1d4e69a",
+ "subscriberUrl": "https://webhook.site/example",
+ "appId": null,
+ "time": 5,
+ "timeUnit": "MINUTE",
+ "eventTriggers": [
+ "AFTER_HOSTS_CAL_VIDEO_NO_SHOW",
+ "AFTER_GUESTS_CAL_VIDEO_NO_SHOW"
+ ],
+ "payloadTemplate": null
+ },
+ "message": "Guest didn't join the call or didn't join before 2025-12-02 04:05:00 +00:00"
+ }
+}
+```
+
### Verifying the authenticity of the received payload
<Steps>
<Step title="Add a new secret key to your webhook">
@@ -182,7 +334,7 @@ where `{{type}}` represents the event type slug and `{{title}}` represents the t
| Variable | Type | Description |
|--------------------|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| triggerEvent | String | The name of the trigger event [BOOKING_CREATED, BOOKING_RESCHEDULED, BOOKING_CANCELLED, MEETING_ENDED, BOOKING_REJECTED, BOOKING_REQUESTED, BOOKING_PAYMENT_INITIATED, BOOKING_PAID, MEETING_STARTED, RECORDING_READY, FORM_SUBMITTED] |
+| triggerEvent | String | The name of the trigger event [BOOKING_CREATED, BOOKING_RESCHEDULED, BOOKING_CANCELLED, MEETING_ENDED, BOOKING_REJECTED, BOOKING_REQUESTED, BOOKING_PAYMENT_INITIATED, BOOKING_PAID, MEETING_STARTED, RECORDING_READY, FORM_SUBMITTED, BOOKING_NO_SHOW_UPDATED, AFTER_HOSTS_CAL_VIDEO_NO_SHOW, AFTER_GUESTS_CAL_VIDEO_NO_SHOW] |
| createdAt | Datetime | The time of the webhook |
| type | String | The event type slug |
| title | String | The event type name |