On event

calcom.onEvent subscribes to every event delivered by the selected managed Cal.com webhook scope.

automations/on-event.automation.ts

import { automation, markSignificant } from "automate.ax"
import { calcom } from "automate.ax/calcom"

export default automation("On event", () => {
  const event = calcom.onEvent()
  markSignificant(event)
})

Scope

Omit scope for the connected user’s personal webhook. Personal and team scopes exclude the four organization-only delegation credential events. Use a team scope for one team-owned Collective or Round Robin event type:

calcom.onEvent({
  scope: { eventTypeId: 23, teamId: 17, type: "team" },
})

Use an organization scope for organization-wide events, including delegation credentials:

calcom.onEvent({
  scope: { organizationId: 7, type: "organization" },
})

Team scope requires a Cal.com Teams plan or higher and an API key owned by a team admin or owner. Organization scope requires an organization admin with webhook permissions; Cal.com marks organization webhooks as an Essentials feature for platform customers.

Event

The signal is a discriminated union. Narrow triggerEvent before reading variant fields. Most variants use createdAt and a nested payload; meeting start and end variants expose booking fields at the event root.

triggerEvent	Semantic trigger	Reference
`AFTER_GUESTS_CAL_VIDEO_NO_SHOW`	`calcom.onAfterGuestsCalVideoNoShow`	after guests cal video no show
`AFTER_HOSTS_CAL_VIDEO_NO_SHOW`	`calcom.onAfterHostsCalVideoNoShow`	after hosts cal video no show
`BOOKING_CANCELLED`	`calcom.onBookingCancelled`	booking cancelled
`BOOKING_CREATED`	`calcom.onBookingCreated`	booking created
`BOOKING_LOCATION_UPDATED`	`calcom.onBookingLocationUpdated`	booking location updated
`BOOKING_NO_SHOW_UPDATED`	`calcom.onBookingNoShowUpdated`	booking no show updated
`BOOKING_PAID`	`calcom.onBookingPaid`	booking paid
`BOOKING_PAYMENT_INITIATED`	`calcom.onBookingPaymentInitiated`	booking payment initiated
`BOOKING_REASSIGNED`	`calcom.onBookingReassigned`	booking reassigned
`BOOKING_REJECTED`	`calcom.onBookingRejected`	booking rejected
`BOOKING_REQUESTED`	`calcom.onBookingRequested`	booking requested
`BOOKING_RESCHEDULED`	`calcom.onBookingRescheduled`	booking rescheduled
`CALENDAR_ENTRY_REJECTED`	`calcom.onCalendarEntryRejected`	calendar entry rejected
`DELEGATION_CREDENTIAL_ERROR`	`calcom.onDelegationCredentialError`	delegation credential error
`DELEGATION_CREDENTIAL_ROTATION_REQUIRED`	`calcom.onDelegationCredentialRotationRequired`	delegation credential rotation required
`DELEGATION_CREDENTIAL_SECRET_ROTATED`	`calcom.onDelegationCredentialSecretRotated`	delegation credential secret rotated
`DELEGATION_CREDENTIAL_SECRET_ROTATION_FAILED`	`calcom.onDelegationCredentialSecretRotationFailed`	delegation credential secret rotation failed
`FORM_SUBMITTED`	`calcom.onFormSubmitted`	form submitted
`FORM_SUBMITTED_NO_EVENT`	`calcom.onFormSubmittedWithoutEvent`	form submitted without event
`INSTANT_MEETING`	`calcom.onInstantMeetingCreated`	instant meeting created
`INSTANT_MEETING_ACCEPTED`	`calcom.onInstantMeetingAccepted`	instant meeting accepted
`MEETING_ENDED`	`calcom.onMeetingEnded`	meeting ended
`MEETING_STARTED`	`calcom.onMeetingStarted`	meeting started
`OOO_CREATED`	`calcom.onOutOfOfficeCreated`	out of office created
`RECORDING_READY`	`calcom.onRecordingReady`	recording ready
`RECORDING_TRANSCRIPTION_GENERATED`	`calcom.onRecordingTranscriptionGenerated`	recording transcription generated
`ROUTING_FORM_FALLBACK_HIT`	`calcom.onRoutingFormFallbackHit`	routing form fallback hit
`WRONG_ASSIGNMENT_REPORT`	`calcom.onWrongAssignmentReported`	wrong assignment reported

Automate.ax creates and maintains the scoped Cal.com webhook, verifies x-cal-signature-256, and deduplicates provider retries. Use calcom.onEvent when one automation should receive every event supported by its selected scope.

Built-in triggers

Built-in actions

Runtime utilities

Integrations

Scope

Event

​Scope

​Event

Scope

Event