> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monobot.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cal.com

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

<Accordion title="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

  ```json theme={null}
  {
    "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.
</Accordion>

<Accordion title="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

  ```json theme={null}
  {
    "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.
</Accordion>

<Accordion title="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

  ```json theme={null}
  {
    "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.
</Accordion>

<Accordion title="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

  ```json theme={null}
  {
    "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
</Accordion>

<Accordion title="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

  ```json theme={null}
  {
    "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
</Accordion>
