Cal Com

Manage Cal.com bookings, event types, schedules, and availability

Cal.com is a flexible and open-source scheduling platform that makes it easy to manage appointments, bookings, event types, and team availabilities.

With Cal.com, you can:

  • Automate scheduling: Allow users to view your available time slots and book meetings automatically, without back-and-forth emails.
  • Manage events: Create and customize event types, durations, and rules for one-on-one or group meetings.
  • Integrate calendars: Seamlessly connect with Google, Outlook, Apple, or other calendar providers to avoid double bookings.
  • Handle attendees and guests: Collect attendee information, manage guests, and send invitations or reminders.
  • Control availability: Define custom working hours, buffer times, and cancellation/rebooking rules.
  • Power workflows: Trigger custom actions via webhooks when a booking is created, cancelled, or rescheduled.

In SteelEngine, the Cal.com integration enables your agents to book meetings, check availabilities, manage event types, and automate scheduling tasks programmatically. This helps agents coordinate meetings, send bookings on behalf of users, check schedules, or respond to booking events—all without manual intervention. By connecting SteelEngine with Cal.com, you unlock highly automated and intelligent scheduling workflows that can integrate seamlessly with your broader automation needs.

Usage Instructions

Integrate Cal.com into your workflow. Create and manage bookings, event types, schedules, and check availability slots. Supports creating, listing, rescheduling, and canceling bookings, as well as managing event types and schedules. Can also trigger workflows based on Cal.com webhook events (booking created, cancelled, rescheduled). Connect your Cal.com account via OAuth.

Tools

calcom_create_booking

Create a new booking on Cal.com

Input

ParameterTypeRequiredDescription
eventTypeIdnumberYesThe ID of the event type to book
startstringYesStart time in UTC ISO 8601 format (e.g., 2024-01-15T09:00:00Z)
attendeeobjectYesAttendee information object with name, email, timeZone, and optional phoneNumber (constructed from individual attendee fields)
guestsarrayNoArray of guest email addresses
itemsstringNoGuest email address
lengthInMinutesnumberNoDuration of the booking in minutes (overrides event type default)
metadataobjectNoCustom metadata to attach to the booking

Output

ParameterTypeDescription
statusstringResponse status
dataobjectCreated booking details
↳ eventTypeobjectEvent type details
↳ idnumberEvent type ID
↳ slugstringEvent type slug
↳ attendeesarrayList of attendees
↳ namestringAttendee name
↳ emailstringAttendee actual email address
↳ displayEmailstringEmail shown publicly (may differ from actual email)
↳ timeZonestringAttendee timezone (IANA format)
↳ phoneNumberstringAttendee phone number
↳ languagestringAttendee language preference (ISO code)
↳ absentbooleanWhether attendee was absent
↳ hostsarrayList of hosts
↳ idnumberHost user ID
↳ namestringHost display name
↳ emailstringHost actual email address
↳ displayEmailstringEmail shown publicly (may differ from actual email)
↳ usernamestringHost Cal.com username
↳ timeZonestringHost timezone (IANA format)
↳ idnumberNumeric booking ID
↳ uidstringUnique identifier for the booking
↳ titlestringTitle of the booking
↳ statusstringBooking status (e.g., accepted, pending, cancelled)
↳ startstringStart time in ISO 8601 format
↳ endstringEnd time in ISO 8601 format
↳ durationnumberDuration in minutes
↳ eventTypeIdnumberEvent type ID
↳ meetingUrlstringURL to join the meeting
↳ locationstringLocation of the booking
↳ absentHostbooleanWhether the host was absent
↳ guestsarrayGuest email addresses
↳ bookingFieldsResponsesjsonCustom booking field responses (dynamic keys based on event type configuration)
↳ metadatajsonCustom metadata attached to the booking (dynamic key-value pairs)
↳ icsUidstringICS calendar UID
↳ createdAtstringWhen the booking was created

calcom_get_booking

Get details of a specific booking by its UID

Input

ParameterTypeRequiredDescription
bookingUidstringYesUnique identifier (UID) of the booking

Output

ParameterTypeDescription
statusstringResponse status
dataobjectBooking details
↳ eventTypeobjectEvent type details
↳ idnumberEvent type ID
↳ slugstringEvent type slug
↳ attendeesarrayList of attendees
↳ namestringAttendee name
↳ emailstringAttendee actual email address
↳ displayEmailstringEmail shown publicly (may differ from actual email)
↳ timeZonestringAttendee timezone (IANA format)
↳ phoneNumberstringAttendee phone number
↳ languagestringAttendee language preference (ISO code)
↳ absentbooleanWhether attendee was absent
↳ hostsarrayList of hosts
↳ idnumberHost user ID
↳ namestringHost display name
↳ emailstringHost actual email address
↳ displayEmailstringEmail shown publicly (may differ from actual email)
↳ usernamestringHost Cal.com username
↳ timeZonestringHost timezone (IANA format)
↳ idnumberNumeric booking ID
↳ uidstringUnique identifier for the booking
↳ titlestringTitle of the booking
↳ descriptionstringDescription of the booking
↳ statusstringBooking status (e.g., accepted, pending, cancelled)
↳ startstringStart time in ISO 8601 format
↳ endstringEnd time in ISO 8601 format
↳ durationnumberDuration in minutes
↳ eventTypeIdnumberEvent type ID
↳ meetingUrlstringURL to join the meeting
↳ locationstringLocation of the booking
↳ absentHostbooleanWhether the host was absent
↳ guestsarrayGuest email addresses
↳ bookingFieldsResponsesjsonCustom booking field responses (dynamic keys based on event type configuration)
↳ metadatajsonCustom metadata attached to the booking (dynamic key-value pairs)
↳ ratingnumberBooking rating
↳ icsUidstringICS calendar UID
↳ cancellationReasonstringReason for cancellation if cancelled
↳ reschedulingReasonstringReason for rescheduling if rescheduled
↳ rescheduledFromUidstringOriginal booking UID if this booking was rescheduled
↳ rescheduledToUidstringNew booking UID after reschedule
↳ cancelledByEmailstringEmail of person who cancelled the booking
↳ rescheduledByEmailstringEmail of person who rescheduled the booking
↳ createdAtstringWhen the booking was created
↳ updatedAtstringWhen the booking was last updated

calcom_list_bookings

List all bookings with optional status filter

Input

ParameterTypeRequiredDescription
statusstringNoFilter bookings by status: upcoming, recurring, past, cancelled, or unconfirmed
takenumberNoNumber of bookings to return (pagination limit)
skipnumberNoNumber of bookings to skip (pagination offset)

Output

ParameterTypeDescription
statusstringResponse status
dataarrayArray of bookings
↳ eventTypeobjectEvent type details
↳ idnumberEvent type ID
↳ slugstringEvent type slug
↳ attendeesarrayList of attendees
↳ namestringAttendee name
↳ emailstringAttendee actual email address
↳ displayEmailstringEmail shown publicly (may differ from actual email)
↳ timeZonestringAttendee timezone (IANA format)
↳ phoneNumberstringAttendee phone number
↳ languagestringAttendee language preference (ISO code)
↳ absentbooleanWhether attendee was absent
↳ hostsarrayList of hosts
↳ idnumberHost user ID
↳ namestringHost display name
↳ emailstringHost actual email address
↳ displayEmailstringEmail shown publicly (may differ from actual email)
↳ usernamestringHost Cal.com username
↳ timeZonestringHost timezone (IANA format)
↳ idnumberNumeric booking ID
↳ uidstringUnique identifier for the booking
↳ titlestringTitle of the booking
↳ descriptionstringDescription of the booking
↳ statusstringBooking status (e.g., accepted, pending, cancelled)
↳ startstringStart time in ISO 8601 format
↳ endstringEnd time in ISO 8601 format
↳ durationnumberDuration in minutes
↳ eventTypeIdnumberEvent type ID
↳ meetingUrlstringURL to join the meeting
↳ locationstringLocation of the booking
↳ absentHostbooleanWhether the host was absent
↳ guestsarrayGuest email addresses
↳ bookingFieldsResponsesjsonCustom booking field responses (dynamic keys based on event type configuration)
↳ metadatajsonCustom metadata attached to the booking (dynamic key-value pairs)
↳ ratingnumberBooking rating
↳ icsUidstringICS calendar UID
↳ cancellationReasonstringReason for cancellation if cancelled
↳ cancelledByEmailstringEmail of person who cancelled the booking
↳ reschedulingReasonstringReason for rescheduling if rescheduled
↳ rescheduledByEmailstringEmail of person who rescheduled the booking
↳ rescheduledFromUidstringOriginal booking UID if this booking was rescheduled
↳ rescheduledToUidstringNew booking UID after reschedule
↳ createdAtstringWhen the booking was created
↳ updatedAtstringWhen the booking was last updated
paginationobjectPagination metadata
↳ totalItemsnumberTotal number of items
↳ remainingItemsnumberRemaining items after current page
↳ returnedItemsnumberNumber of items returned in this response
↳ itemsPerPagenumberItems per page
↳ currentPagenumberCurrent page number
↳ totalPagesnumberTotal number of pages
↳ hasNextPagebooleanWhether there is a next page
↳ hasPreviousPagebooleanWhether there is a previous page

calcom_cancel_booking

Cancel an existing booking

Input

ParameterTypeRequiredDescription
bookingUidstringYesUnique identifier (UID) of the booking to cancel
cancellationReasonstringNoReason for cancelling the booking

Output

ParameterTypeDescription
statusstringResponse status
dataobjectCancelled booking details
↳ eventTypeobjectEvent type details
↳ idnumberEvent type ID
↳ slugstringEvent type slug
↳ attendeesarrayList of attendees
↳ namestringAttendee name
↳ emailstringAttendee actual email address
↳ displayEmailstringEmail shown publicly (may differ from actual email)
↳ timeZonestringAttendee timezone (IANA format)
↳ phoneNumberstringAttendee phone number
↳ languagestringAttendee language preference (ISO code)
↳ absentbooleanWhether attendee was absent
↳ hostsarrayList of hosts
↳ idnumberHost user ID
↳ namestringHost display name
↳ emailstringHost actual email address
↳ displayEmailstringEmail shown publicly (may differ from actual email)
↳ usernamestringHost Cal.com username
↳ timeZonestringHost timezone (IANA format)
↳ idnumberNumeric booking ID
↳ uidstringUnique identifier for the booking
↳ titlestringTitle of the booking
↳ cancellationReasonstringReason for cancellation if cancelled
↳ cancelledByEmailstringEmail of person who cancelled the booking
↳ startstringStart time in ISO 8601 format
↳ endstringEnd time in ISO 8601 format
↳ durationnumberDuration in minutes
↳ eventTypeIdnumberEvent type ID
↳ locationstringLocation of the booking
↳ metadatajsonCustom metadata attached to the booking (dynamic key-value pairs)
↳ createdAtstringWhen the booking was created
↳ statusstringBooking status (should be cancelled)

calcom_reschedule_booking

Reschedule an existing booking to a new time

Input

ParameterTypeRequiredDescription
bookingUidstringYesUnique identifier (UID) of the booking to reschedule
startstringYesNew start time in UTC ISO 8601 format (e.g., 2024-01-15T09:00:00Z)
reschedulingReasonstringNoReason for rescheduling the booking

Output

ParameterTypeDescription
statusstringResponse status
dataobjectRescheduled booking details
↳ eventTypeobjectEvent type details
↳ idnumberEvent type ID
↳ slugstringEvent type slug
↳ attendeesarrayList of attendees
↳ namestringAttendee name
↳ emailstringAttendee actual email address
↳ displayEmailstringEmail shown publicly (may differ from actual email)
↳ timeZonestringAttendee timezone (IANA format)
↳ phoneNumberstringAttendee phone number
↳ languagestringAttendee language preference (ISO code)
↳ absentbooleanWhether attendee was absent
↳ hostsarrayList of hosts
↳ idnumberHost user ID
↳ namestringHost display name
↳ emailstringHost actual email address
↳ displayEmailstringEmail shown publicly (may differ from actual email)
↳ usernamestringHost Cal.com username
↳ timeZonestringHost timezone (IANA format)
↳ idnumberNumeric booking ID
↳ titlestringTitle of the booking
↳ statusstringBooking status (e.g., accepted, pending, cancelled)
↳ reschedulingReasonstringReason for rescheduling if rescheduled
↳ rescheduledFromUidstringOriginal booking UID if this booking was rescheduled
↳ rescheduledByEmailstringEmail of person who rescheduled the booking
↳ durationnumberDuration in minutes
↳ eventTypeIdnumberEvent type ID
↳ meetingUrlstringURL to join the meeting
↳ locationstringLocation of the booking
↳ guestsarrayGuest email addresses
↳ metadatajsonCustom metadata attached to the booking (dynamic key-value pairs)
↳ icsUidstringICS calendar UID
↳ createdAtstringWhen the booking was created
↳ uidstringUnique identifier for the new booking
↳ startstringNew start time in ISO 8601 format
↳ endstringNew end time in ISO 8601 format

calcom_confirm_booking

Confirm a pending booking that requires confirmation

Input

ParameterTypeRequiredDescription
bookingUidstringYesUnique identifier (UID) of the booking to confirm

Output

ParameterTypeDescription
statusstringResponse status
dataobjectConfirmed booking details
↳ eventTypeobjectEvent type details
↳ idnumberEvent type ID
↳ slugstringEvent type slug
↳ attendeesarrayList of attendees
↳ namestringAttendee name
↳ emailstringAttendee actual email address
↳ displayEmailstringEmail shown publicly (may differ from actual email)
↳ timeZonestringAttendee timezone (IANA format)
↳ phoneNumberstringAttendee phone number
↳ languagestringAttendee language preference (ISO code)
↳ absentbooleanWhether attendee was absent
↳ hostsarrayList of hosts
↳ idnumberHost user ID
↳ namestringHost display name
↳ emailstringHost actual email address
↳ displayEmailstringEmail shown publicly (may differ from actual email)
↳ usernamestringHost Cal.com username
↳ timeZonestringHost timezone (IANA format)
↳ idnumberNumeric booking ID
↳ uidstringUnique identifier for the booking
↳ titlestringTitle of the booking
↳ startstringStart time in ISO 8601 format
↳ endstringEnd time in ISO 8601 format
↳ durationnumberDuration in minutes
↳ eventTypeIdnumberEvent type ID
↳ meetingUrlstringURL to join the meeting
↳ locationstringLocation of the booking
↳ guestsarrayGuest email addresses
↳ metadatajsonCustom metadata attached to the booking (dynamic key-value pairs)
↳ icsUidstringICS calendar UID
↳ createdAtstringWhen the booking was created
↳ statusstringBooking status (should be accepted/confirmed)

calcom_decline_booking

Decline a pending booking request

Input

ParameterTypeRequiredDescription
bookingUidstringYesUnique identifier (UID) of the booking to decline
reasonstringNoReason for declining the booking

Output

ParameterTypeDescription
statusstringResponse status
dataobjectDeclined booking details
↳ eventTypeobjectEvent type details
↳ idnumberEvent type ID
↳ slugstringEvent type slug
↳ attendeesarrayList of attendees
↳ namestringAttendee name
↳ emailstringAttendee actual email address
↳ displayEmailstringEmail shown publicly (may differ from actual email)
↳ timeZonestringAttendee timezone (IANA format)
↳ phoneNumberstringAttendee phone number
↳ languagestringAttendee language preference (ISO code)
↳ absentbooleanWhether attendee was absent
↳ hostsarrayList of hosts
↳ idnumberHost user ID
↳ namestringHost display name
↳ emailstringHost actual email address
↳ displayEmailstringEmail shown publicly (may differ from actual email)
↳ usernamestringHost Cal.com username
↳ timeZonestringHost timezone (IANA format)
↳ idnumberNumeric booking ID
↳ uidstringUnique identifier for the booking
↳ titlestringTitle of the booking
↳ cancellationReasonstringReason for cancellation if cancelled
↳ startstringStart time in ISO 8601 format
↳ endstringEnd time in ISO 8601 format
↳ durationnumberDuration in minutes
↳ eventTypeIdnumberEvent type ID
↳ locationstringLocation of the booking
↳ metadatajsonCustom metadata attached to the booking (dynamic key-value pairs)
↳ createdAtstringWhen the booking was created
↳ statusstringBooking status (should be cancelled/rejected)

calcom_create_event_type

Create a new event type in Cal.com

Input

ParameterTypeRequiredDescription
titlestringYesTitle of the event type
slugstringYesUnique slug for the event type URL
lengthInMinutesnumberYesDuration of the event in minutes
descriptionstringNoDescription of the event type
slotIntervalnumberNoInterval between available booking slots in minutes
minimumBookingNoticenumberNoMinimum notice required before booking in minutes
beforeEventBuffernumberNoBuffer time before the event in minutes
afterEventBuffernumberNoBuffer time after the event in minutes
scheduleIdnumberNoID of the schedule to use for availability
disableGuestsbooleanNoWhether to disable guests from being added to bookings

Output

ParameterTypeDescription
statusstringResponse status
dataobjectCreated event type details
↳ idnumberEvent type ID
↳ titlestringEvent type title
↳ slugstringEvent type slug
↳ descriptionstringEvent type description
↳ lengthInMinutesnumberDuration in minutes
↳ slotIntervalnumberSlot interval in minutes
↳ minimumBookingNoticenumberMinimum booking notice in minutes
↳ beforeEventBuffernumberBuffer before event in minutes
↳ afterEventBuffernumberBuffer after event in minutes
↳ scheduleIdnumberSchedule ID
↳ disableGuestsbooleanWhether guests are disabled
↳ createdAtstringISO timestamp of creation
↳ updatedAtstringISO timestamp of last update

calcom_get_event_type

Get detailed information about a specific event type

Input

ParameterTypeRequiredDescription
eventTypeIdnumberYesEvent type ID to retrieve

Output

ParameterTypeDescription
statusstringResponse status
dataobjectEvent type details
↳ idnumberEvent type ID
↳ titlestringEvent type title
↳ slugstringEvent type slug
↳ descriptionstringEvent type description
↳ lengthInMinutesnumberDuration in minutes
↳ slotIntervalnumberSlot interval in minutes
↳ minimumBookingNoticenumberMinimum booking notice in minutes
↳ beforeEventBuffernumberBuffer before event in minutes
↳ afterEventBuffernumberBuffer after event in minutes
↳ scheduleIdnumberSchedule ID
↳ disableGuestsbooleanWhether guests are disabled
↳ createdAtstringISO timestamp of creation
↳ updatedAtstringISO timestamp of last update

calcom_list_event_types

Retrieve a list of all event types

Input

ParameterTypeRequiredDescription
sortCreatedAtstringNoSort by creation date: "asc" or "desc"

Output

ParameterTypeDescription
statusstringResponse status
dataarrayArray of event types
↳ idnumberEvent type ID
↳ titlestringEvent type title
↳ slugstringEvent type slug
↳ descriptionstringEvent type description
↳ lengthInMinutesnumberDuration in minutes
↳ slotIntervalnumberSlot interval in minutes
↳ minimumBookingNoticenumberMinimum booking notice in minutes
↳ beforeEventBuffernumberBuffer before event in minutes
↳ afterEventBuffernumberBuffer after event in minutes
↳ scheduleIdnumberSchedule ID
↳ disableGuestsbooleanWhether guests are disabled
↳ createdAtstringISO timestamp of creation
↳ updatedAtstringISO timestamp of last update

calcom_update_event_type

Update an existing event type in Cal.com

Input

ParameterTypeRequiredDescription
eventTypeIdnumberYesEvent type ID to update (e.g., 12345)
titlestringNoTitle of the event type
slugstringNoUnique slug for the event type URL
lengthInMinutesnumberNoDuration of the event in minutes
descriptionstringNoDescription of the event type
slotIntervalnumberNoInterval between available booking slots in minutes
minimumBookingNoticenumberNoMinimum notice required before booking in minutes
beforeEventBuffernumberNoBuffer time before the event in minutes
afterEventBuffernumberNoBuffer time after the event in minutes
scheduleIdnumberNoID of the schedule to use for availability
disableGuestsbooleanNoWhether to disable guests from being added to bookings

Output

ParameterTypeDescription
statusstringResponse status
dataobjectUpdated event type details
↳ idnumberEvent type ID
↳ titlestringEvent type title
↳ slugstringEvent type slug
↳ descriptionstringEvent type description
↳ lengthInMinutesnumberDuration in minutes
↳ slotIntervalnumberSlot interval in minutes
↳ minimumBookingNoticenumberMinimum booking notice in minutes
↳ beforeEventBuffernumberBuffer before event in minutes
↳ afterEventBuffernumberBuffer after event in minutes
↳ scheduleIdnumberSchedule ID
↳ disableGuestsbooleanWhether guests are disabled
↳ createdAtstringISO timestamp of creation
↳ updatedAtstringISO timestamp of last update

calcom_delete_event_type

Delete an event type from Cal.com

Input

ParameterTypeRequiredDescription
eventTypeIdnumberYesEvent type ID to delete

Output

ParameterTypeDescription
statusstringResponse status
dataobjectDeleted event type details
↳ idnumberEvent type ID
↳ lengthInMinutesnumberDuration in minutes
↳ titlestringEvent type title
↳ slugstringEvent type slug

calcom_create_schedule

Create a new availability schedule in Cal.com

Input

ParameterTypeRequiredDescription
namestringYesName of the schedule
timeZonestringYesTimezone for the schedule (e.g., America/New_York)
isDefaultbooleanYesWhether this schedule should be the default
availabilityarrayNoAvailability intervals for the schedule
itemsobjectNoAvailability interval
propertiesarrayNoDays of the week (Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday)
daysarrayNoDays of the week (Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday)
startTimestringNoStart time in HH:MM format
endTimestringNoEnd time in HH:MM format

Output

ParameterTypeDescription
statusstringResponse status
dataobjectCreated schedule data
↳ idnumberSchedule ID
↳ ownerIdnumberOwner user ID
↳ namestringSchedule name
↳ timeZonestringTimezone (e.g., America/New_York)
↳ isDefaultbooleanWhether this is the default schedule
↳ availabilityarrayAvailability windows
↳ daysarrayDays of the week (Monday, Tuesday, etc.)
↳ startTimestringStart time in HH:MM format
↳ endTimestringEnd time in HH:MM format
↳ overridesarrayDate-specific availability overrides
↳ datestringDate in YYYY-MM-DD format
↳ startTimestringStart time in HH:MM format
↳ endTimestringEnd time in HH:MM format

calcom_get_schedule

Get a specific schedule by ID from Cal.com

Input

ParameterTypeRequiredDescription
scheduleIdstringYesID of the schedule to retrieve

Output

ParameterTypeDescription
statusstringResponse status
dataobjectSchedule data
↳ idnumberSchedule ID
↳ ownerIdnumberOwner user ID
↳ namestringSchedule name
↳ timeZonestringTimezone (e.g., America/New_York)
↳ isDefaultbooleanWhether this is the default schedule
↳ availabilityarrayAvailability windows
↳ daysarrayDays of the week (Monday, Tuesday, etc.)
↳ startTimestringStart time in HH:MM format
↳ endTimestringEnd time in HH:MM format
↳ overridesarrayDate-specific availability overrides
↳ datestringDate in YYYY-MM-DD format
↳ startTimestringStart time in HH:MM format
↳ endTimestringEnd time in HH:MM format

calcom_list_schedules

List all availability schedules from Cal.com

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
statusstringResponse status
dataarrayArray of schedule objects
↳ idnumberSchedule ID
↳ ownerIdnumberOwner user ID
↳ namestringSchedule name
↳ timeZonestringTimezone (e.g., America/New_York)
↳ isDefaultbooleanWhether this is the default schedule
↳ availabilityarrayAvailability windows
↳ daysarrayDays of the week (Monday, Tuesday, etc.)
↳ startTimestringStart time in HH:MM format
↳ endTimestringEnd time in HH:MM format
↳ overridesarrayDate-specific availability overrides
↳ datestringDate in YYYY-MM-DD format
↳ startTimestringStart time in HH:MM format
↳ endTimestringEnd time in HH:MM format

calcom_update_schedule

Update an existing schedule in Cal.com

Input

ParameterTypeRequiredDescription
scheduleIdstringYesID of the schedule to update
namestringNoNew name for the schedule
timeZonestringNoNew timezone for the schedule (e.g., America/New_York)
isDefaultbooleanNoWhether this schedule should be the default
availabilityarrayNoNew availability intervals for the schedule
itemsobjectNoAvailability interval
propertiesarrayNoDays of the week (Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday)
daysarrayNoDays of the week (Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday)
startTimestringNoStart time in HH:MM format
endTimestringNoEnd time in HH:MM format

Output

ParameterTypeDescription
statusstringResponse status
dataobjectUpdated schedule data
↳ idnumberSchedule ID
↳ ownerIdnumberOwner user ID
↳ namestringSchedule name
↳ timeZonestringTimezone (e.g., America/New_York)
↳ isDefaultbooleanWhether this is the default schedule
↳ availabilityarrayAvailability windows
↳ daysarrayDays of the week (Monday, Tuesday, etc.)
↳ startTimestringStart time in HH:MM format
↳ endTimestringEnd time in HH:MM format
↳ overridesarrayDate-specific availability overrides
↳ datestringDate in YYYY-MM-DD format
↳ startTimestringStart time in HH:MM format
↳ endTimestringEnd time in HH:MM format

calcom_delete_schedule

Delete a schedule from Cal.com

Input

ParameterTypeRequiredDescription
scheduleIdstringYesID of the schedule to delete

Output

ParameterTypeDescription
statusstringResponse status (success or error)

calcom_get_default_schedule

Get the default availability schedule from Cal.com

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
statusstringResponse status
dataobjectDefault schedule data
↳ idnumberSchedule ID
↳ ownerIdnumberOwner user ID
↳ namestringSchedule name
↳ timeZonestringTimezone (e.g., America/New_York)
↳ isDefaultbooleanWhether this is the default schedule
↳ availabilityarrayAvailability windows
↳ daysarrayDays of the week (Monday, Tuesday, etc.)
↳ startTimestringStart time in HH:MM format
↳ endTimestringEnd time in HH:MM format
↳ overridesarrayDate-specific availability overrides
↳ datestringDate in YYYY-MM-DD format
↳ startTimestringStart time in HH:MM format
↳ endTimestringEnd time in HH:MM format

calcom_get_slots

Get available booking slots for a Cal.com event type within a time range

Input

ParameterTypeRequiredDescription
startstringYesStart of time range in UTC ISO 8601 format (e.g., 2024-01-15T00:00:00Z)
endstringYesEnd of time range in UTC ISO 8601 format (e.g., 2024-01-22T00:00:00Z)
eventTypeIdnumberNoEvent type ID for direct lookup
eventTypeSlugstringNoEvent type slug (requires username to be set)
usernamestringNoUsername for personal event types (required when using eventTypeSlug)
timeZonestringNoTimezone for returned slots (defaults to UTC)
durationnumberNoSlot length in minutes

Output

ParameterTypeDescription
statusstringResponse status
datajsonAvailable time slots grouped by date (YYYY-MM-DD keys). Each date maps to an array of slot objects with start time, optional end time, and seated event info.

Triggers

A workflow can start when one of these Cal Com events occurs.

CalCom Booking Created

Trigger workflow when a new booking is created in Cal.com

Cal Com sends the event to the webhook URL shown in the block.

Configuration

FieldTypeDescription
Webhook SecrettextUsed to verify webhook requests via X-Cal-Signature-256 header.

Output

FieldTypeDescription
triggerEventstringThe webhook event type
createdAtstringWhen the webhook event was created (ISO 8601)
payloadobject
↳ titlestringBooking title
↳ descriptionstringBooking description
↳ eventTypeIdnumberEvent type ID
↳ startTimestringBooking start time (ISO 8601)
↳ endTimestringBooking end time (ISO 8601)
↳ uidstringUnique booking identifier
↳ bookingIdnumberNumeric booking ID
↳ statusstringBooking status
↳ locationstringMeeting location or URL
↳ organizerobjectOrganizer details
↳ idnumberOrganizer user ID
↳ namestringOrganizer name
↳ emailstringOrganizer email
↳ usernamestringOrganizer username
↳ timeZonestringOrganizer timezone
↳ attendeesarrayList of attendees
↳ namestringAttendee name
↳ emailstringAttendee email
↳ timeZonestringAttendee timezone
↳ languagestringAttendee language preference
↳ responsesjsonBooking form responses (dynamic - fields depend on your event type configuration)
↳ metadatajsonCustom metadata attached to the booking (dynamic - user-defined key-value pairs)
↳ videoCallDatajsonVideo call details (structure varies by provider)

CalCom Booking Cancelled

Trigger workflow when a booking is cancelled in Cal.com

Cal Com sends the event to the webhook URL shown in the block.

Configuration

FieldTypeDescription
Webhook SecrettextUsed to verify webhook requests via X-Cal-Signature-256 header.

Output

FieldTypeDescription
triggerEventstringThe webhook event type
createdAtstringWhen the webhook event was created (ISO 8601)
payloadobject
↳ titlestringBooking title
↳ descriptionstringBooking description
↳ eventTypeIdnumberEvent type ID
↳ startTimestringBooking start time (ISO 8601)
↳ endTimestringBooking end time (ISO 8601)
↳ uidstringUnique booking identifier
↳ bookingIdnumberNumeric booking ID
↳ statusstringBooking status
↳ locationstringMeeting location or URL
↳ cancellationReasonstringReason for cancellation
↳ organizerobjectOrganizer details
↳ idnumberOrganizer user ID
↳ namestringOrganizer name
↳ emailstringOrganizer email
↳ usernamestringOrganizer username
↳ timeZonestringOrganizer timezone
↳ attendeesarrayList of attendees
↳ namestringAttendee name
↳ emailstringAttendee email
↳ timeZonestringAttendee timezone
↳ languagestringAttendee language preference
↳ responsesjsonBooking form responses
↳ metadatajsonCustom metadata attached to the booking

CalCom Booking Rescheduled

Trigger workflow when a booking is rescheduled in Cal.com

Cal Com sends the event to the webhook URL shown in the block.

Configuration

FieldTypeDescription
Webhook SecrettextUsed to verify webhook requests via X-Cal-Signature-256 header.

Output

FieldTypeDescription
triggerEventstringThe webhook event type
createdAtstringWhen the webhook event was created (ISO 8601)
payloadobject
↳ titlestringBooking title
↳ descriptionstringBooking description
↳ eventTypeIdnumberEvent type ID
↳ startTimestringNew booking start time (ISO 8601)
↳ endTimestringNew booking end time (ISO 8601)
↳ uidstringUnique booking identifier
↳ bookingIdnumberNumeric booking ID
↳ statusstringBooking status
↳ locationstringMeeting location or URL
↳ rescheduleIdnumberPrevious booking ID
↳ rescheduleUidstringPrevious booking UID
↳ rescheduleStartTimestringOriginal start time (ISO 8601)
↳ rescheduleEndTimestringOriginal end time (ISO 8601)
↳ organizerobjectOrganizer details
↳ idnumberOrganizer user ID
↳ namestringOrganizer name
↳ emailstringOrganizer email
↳ usernamestringOrganizer username
↳ timeZonestringOrganizer timezone
↳ attendeesarrayList of attendees
↳ namestringAttendee name
↳ emailstringAttendee email
↳ timeZonestringAttendee timezone
↳ languagestringAttendee language preference
↳ responsesjsonBooking form responses
↳ metadatajsonCustom metadata attached to the booking

CalCom Booking Requested

Trigger workflow when a booking request is submitted (pending confirmation)

Cal Com sends the event to the webhook URL shown in the block.

Configuration

FieldTypeDescription
Webhook SecrettextUsed to verify webhook requests via X-Cal-Signature-256 header.

Output

FieldTypeDescription
triggerEventstringThe webhook event type (BOOKING_REQUESTED)
createdAtstringWhen the webhook event was created (ISO 8601)
payloadobject
↳ titlestringBooking title
↳ descriptionstringBooking description
↳ eventTypeIdnumberEvent type ID
↳ startTimestringRequested start time (ISO 8601)
↳ endTimestringRequested end time (ISO 8601)
↳ uidstringUnique booking identifier
↳ bookingIdnumberNumeric booking ID
↳ statusstringBooking status (pending)
↳ locationstringMeeting location or URL
↳ organizerobjectOrganizer details
↳ idnumberOrganizer user ID
↳ namestringOrganizer name
↳ emailstringOrganizer email
↳ usernamestringOrganizer username
↳ timeZonestringOrganizer timezone
↳ attendeesarrayList of attendees
↳ namestringAttendee name
↳ emailstringAttendee email
↳ timeZonestringAttendee timezone
↳ languagestringAttendee language preference
↳ responsesjsonBooking form responses
↳ metadatajsonCustom metadata attached to the booking

CalCom Booking Rejected

Trigger workflow when a booking request is rejected by the host

Cal Com sends the event to the webhook URL shown in the block.

Configuration

FieldTypeDescription
Webhook SecrettextUsed to verify webhook requests via X-Cal-Signature-256 header.

Output

FieldTypeDescription
triggerEventstringThe webhook event type (BOOKING_REJECTED)
createdAtstringWhen the webhook event was created (ISO 8601)
payloadobject
↳ titlestringBooking title
↳ descriptionstringBooking description
↳ eventTypeIdnumberEvent type ID
↳ startTimestringRequested start time (ISO 8601)
↳ endTimestringRequested end time (ISO 8601)
↳ uidstringUnique booking identifier
↳ bookingIdnumberNumeric booking ID
↳ statusstringBooking status (rejected)
↳ rejectionReasonstringReason for rejection provided by host
↳ organizerobjectOrganizer details
↳ idnumberOrganizer user ID
↳ namestringOrganizer name
↳ emailstringOrganizer email
↳ usernamestringOrganizer username
↳ timeZonestringOrganizer timezone
↳ attendeesarrayList of attendees
↳ namestringAttendee name
↳ emailstringAttendee email
↳ timeZonestringAttendee timezone
↳ languagestringAttendee language preference
↳ metadatajsonCustom metadata attached to the booking

CalCom Booking Paid

Trigger workflow when payment is completed for a paid booking

Cal Com sends the event to the webhook URL shown in the block.

Configuration

FieldTypeDescription
Webhook SecrettextUsed to verify webhook requests via X-Cal-Signature-256 header.

Output

FieldTypeDescription
triggerEventstringThe webhook event type (BOOKING_PAID)
createdAtstringWhen the webhook event was created (ISO 8601)
payloadobject
↳ titlestringBooking title
↳ descriptionstringBooking description
↳ eventTypeIdnumberEvent type ID
↳ startTimestringBooking start time (ISO 8601)
↳ endTimestringBooking end time (ISO 8601)
↳ uidstringUnique booking identifier
↳ bookingIdnumberNumeric booking ID
↳ statusstringBooking status
↳ locationstringMeeting location or URL
↳ paymentobjectPayment details
↳ idstringPayment ID
↳ amountnumberPayment amount
↳ currencystringPayment currency
↳ successbooleanWhether payment succeeded
↳ organizerobjectOrganizer details
↳ idnumberOrganizer user ID
↳ namestringOrganizer name
↳ emailstringOrganizer email
↳ usernamestringOrganizer username
↳ timeZonestringOrganizer timezone
↳ attendeesarrayList of attendees
↳ namestringAttendee name
↳ emailstringAttendee email
↳ timeZonestringAttendee timezone
↳ languagestringAttendee language preference
↳ metadatajsonCustom metadata attached to the booking

CalCom Meeting Ended

Trigger workflow when a Cal.com meeting ends

Cal Com sends the event to the webhook URL shown in the block.

Configuration

FieldTypeDescription
Webhook SecrettextUsed to verify webhook requests via X-Cal-Signature-256 header.

Output

FieldTypeDescription
triggerEventstringThe webhook event type (MEETING_ENDED)
createdAtstringWhen the webhook event was created (ISO 8601)
payloadobject
↳ titlestringMeeting title
↳ eventTypeIdnumberEvent type ID
↳ startTimestringMeeting start time (ISO 8601)
↳ endTimestringMeeting end time (ISO 8601)
↳ uidstringUnique booking identifier
↳ bookingIdnumberNumeric booking ID
↳ durationnumberActual meeting duration in minutes
↳ organizerobjectOrganizer details
↳ idnumberOrganizer user ID
↳ namestringOrganizer name
↳ emailstringOrganizer email
↳ usernamestringOrganizer username
↳ timeZonestringOrganizer timezone
↳ attendeesarrayList of attendees
↳ namestringAttendee name
↳ emailstringAttendee email
↳ timeZonestringAttendee timezone
↳ languagestringAttendee language preference
↳ videoCallDatajsonVideo call details

CalCom Recording Ready

Trigger workflow when a meeting recording is ready for download

Cal Com sends the event to the webhook URL shown in the block.

Configuration

FieldTypeDescription
Webhook SecrettextUsed to verify webhook requests via X-Cal-Signature-256 header.

Output

FieldTypeDescription
triggerEventstringThe webhook event type (RECORDING_READY)
createdAtstringWhen the webhook event was created (ISO 8601)
payloadobject
↳ titlestringMeeting title
↳ eventTypeIdnumberEvent type ID
↳ startTimestringMeeting start time (ISO 8601)
↳ endTimestringMeeting end time (ISO 8601)
↳ uidstringUnique booking identifier
↳ bookingIdnumberNumeric booking ID
↳ recordingUrlstringURL to download the recording
↳ transcriptionstringMeeting transcription text (if available)
↳ organizerobjectOrganizer details
↳ idnumberOrganizer user ID
↳ namestringOrganizer name
↳ emailstringOrganizer email
↳ usernamestringOrganizer username
↳ timeZonestringOrganizer timezone
↳ attendeesarrayList of attendees
↳ namestringAttendee name
↳ emailstringAttendee email
↳ timeZonestringAttendee timezone
↳ languagestringAttendee language preference

CalCom Webhook (All Events)

Trigger workflow on any Cal.com webhook event (configure event types in Cal.com)

Cal Com sends the event to the webhook URL shown in the block.

Configuration

FieldTypeDescription
Webhook SecrettextUsed to verify webhook requests via X-Cal-Signature-256 header.

Output

FieldTypeDescription
triggerEventstringThe webhook event type (e.g., BOOKING_CREATED, MEETING_ENDED)
createdAtstringWhen the webhook event was created (ISO 8601)
payloadjsonComplete webhook payload (structure varies by event type)

On this page