The Cal.com integration allows AI assistants to search availability, create bookings, update appointments, and manage scheduling workflows directly through Cal.com. This integration is commonly used for:

Appointment scheduling
Consultation booking
Calendar automation
Meeting management
Rescheduling workflows

Available Actions

Search Available Slots

Searches available booking slots in Cal.com for the selected event type and date range.This action retrieves free time slots based on connected calendar availability and event configuration.

Parameters

Parameter	Required	Description
Event Type ID	Yes	Cal.com event type used for slot search.
Start Date Time	Yes	Start date and time for availability search range.
End Date Time	Yes	End date and time for availability search range.
Timezone	No	Timezone used during slot search and display.

Output

Returns a list of available booking slots within the selected date range.

Example

{
  "success": true,
  "slots": [
    "2026-05-20T10:00:00Z",
    "2026-05-20T10:30:00Z",
    "2026-05-20T11:00:00Z"
  ]
}

Use Cases

Find free appointment times
Suggest available meeting slots
Validate booking availability
Prepare booking workflows
Synchronize scheduling systems

Notes

Valid Cal.com integration credentials are required.
Returned slots depend on connected calendar availability.
Availability is generated dynamically in real time.
Timezone affects displayed slot times.
Available slots may change during the conversation.

Create Booking

Creates a new booking in Cal.com using the selected event type, date, and client information.This action automatically schedules a calendar event and synchronizes it with connected calendars and workflows.

Parameters

Parameter	Required	Description
Event Type ID	Yes	Cal.com event type used for the booking.
Start Date Time	Yes	Booking start date and time.
Client Name	Yes	Name of the client for the booking.
Client Email	Yes	Client email address used for booking confirmation.
Timezone	No	Timezone used during booking creation.
Async	No	Executes the action in the background without blocking the conversation flow.

Output

Returns confirmation that the booking was successfully created.

Example

{
  "success": true,
  "message": "New calendar event has been created."
}

Use Cases

Schedule appointments
Create consultation meetings
Book support calls
Reserve calendar slots
Automate scheduling workflows

Notes

Valid Cal.com integration credentials are required.
Selected event type must exist and be available.
Booking creation depends on real-time slot availability.
Connected calendars and notifications may update automatically.
Client email may receive booking confirmation from Cal.com.

Get Bookings

Retrieves existing Cal.com bookings within the selected date range and event type.This action can be used to search scheduled appointments, validate reservations, and retrieve upcoming or historical booking information.

Parameters

Parameter	Required	Description
Event Type ID	Yes	Cal.com event type used for booking filtering.
Start Date Time	Yes	Start date and time for booking search range.
End Date Time	Yes	End date and time for booking search range.
Timezone	No	Timezone used during booking retrieval.

Output

Returns a list of bookings matching the selected filters and time range.

Example

{
  "success": true,
  "bookings": [
    {
      "booking_id": "12345",
      "client_name": "John Doe",
      "start_time": "2026-05-20T10:00:00Z",
      "end_time": "2026-05-20T10:30:00Z"
    }
  ]
}

Use Cases

Retrieve upcoming appointments
Validate booking existence
Search reservations by date range
Prepare booking reschedule workflows
Display scheduled events to clients

Notes

Valid Cal.com integration credentials are required.
Returned bookings depend on selected event type and date range.
Timezone affects booking filtering and displayed event times.
Historical and future bookings may both be returned depending on the selected range.

Reschedule Booking

Updates an existing Cal.com booking with a new date and time.This action automatically moves the existing appointment to a new available slot and synchronizes connected calendars.

Parameters

Parameter	Required	Description
Event Type ID	Yes	Cal.com event type used for the booking.
Booking ID	Yes	Unique booking identifier to reschedule.
New Start Date Time	Yes	New booking start date and time.
Timezone	No	Timezone used during rescheduling.

Output

Returns confirmation that the booking was successfully rescheduled.

Example

{
  "success": true,
  "message": "The calendar event has been rescheduled."
}

Use Cases

Change appointment time
Move meetings to another slot
Resolve scheduling conflicts
Update customer reservations
Synchronize calendar updates

Notes

Valid Cal.com integration credentials are required.
Original booking must exist before rescheduling.
New selected slot must be available.
Connected calendars and notifications may update automatically.
Rescheduling may trigger confirmation emails from Cal

Cancel Booking

Cancel an existing Cal.com booking using the selected event type and booking identifier.This action can be used to remove scheduled appointments, free reserved slots, and update connected calendars automatically.

Parameters

Parameter	Required	Description
Event Type ID	Yes	Cal.com event type used for the booking.
Booking ID	Yes	Unique booking identifier to cancel.
Timezone	No	Timezone used during booking processing.
Async	No	Executes the action in the background without blocking the conversation flow.

Output

Returns confirmation that the booking was successfully canceled.

Example

{
  "success": true,
  "message": "Existing calendar event has been deleted."
}

Use Cases Cancel customer appointments Remove outdated bookings Free occupied calendar slots Handle reschedule workflows Synchronize external calendars

Documentation Index

​Available Actions

​Parameters

​Output

​Example

​Use Cases

​Notes

​Parameters

​Output

​Example

​Use Cases

​Notes

​Parameters

​Output

​Example

​Use Cases

​Notes

​Parameters

​Output

​Example

​Use Cases

​Notes

​Parameters

​Output

​Example

Available Actions

Parameters

Output

Example

Use Cases

Notes

Parameters

Output

Example

Use Cases

Notes

Parameters

Output

Example

Use Cases

Notes

Parameters

Output

Example

Use Cases

Notes

Parameters

Output

Example