Cal.com Integration — ModuleX AI

Field	Description	Required	Format
Cal.com API Key	Your Cal.com v2 API key from Settings > Developer > API Keys	Yes	`cal_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

create_booking — Create a new booking on Cal.com

Parameters

string

required

Type of booking: booking, instant, or recurring

string

required

Full name of the attendee

string

required

Time zone of the attendee, e.g. America/New_York

string

required

Booking start time in ISO 8601 UTC format, e.g. 2024-08-13T09:00:00Z

string

Email address of the attendee

string

Phone number in international format, e.g. +919876543210

string

Language for the booking confirmation

integer

ID of the event type (alternative to slug-based identification)

string

Slug of the event type (use with username or team_slug)

string

Username of the individual event owner

string

Team slug for team event type identification

string

Organization slug for slug-based event type identification

string

Booking end time in ISO 8601 format

integer

Override the event type default duration in minutes

array

Additional guest email addresses to invite

string

Meeting location type: attendeeAddress, attendeeDefined, attendeePhone, integration

string

Physical address if location is attendeeAddress

string

Location string if location is attendeeDefined

string

Phone number if location is attendeePhone

string

Video conferencing integration if location is integration

integer

Number of occurrences for recurring booking type

object

Custom key-value metadata, e.g. {“source”: “website”}

object

Responses to custom booking form fields keyed by field slug

boolean

Bypass availability checks and allow double-booking

boolean

Allow booking outside the event type scheduling window

string

Required when event type has email verification enabled

Response

{
  "$defs": {
    "BookingItem": {
      "additionalProperties": false,
      "description": "A booking object returned by the Cal.com API.",
      "properties": {
        "uid": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Uid"
        },
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Title"
        },
        "status": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Status"
        },
        "start": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Start"
        },
        "end": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "End"
        },
        "attendees": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Attendees",
          "type": "array"
        },
        "hosts": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Hosts",
          "type": "array"
        },
        "event_type_id": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Event Type Id"
        },
        "meeting_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Meeting Url"
        },
        "location": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Location"
        }
      },
      "title": "BookingItem",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Status"
    },
    "booking": {
      "anyOf": [
        {
          "$ref": "#/$defs/BookingItem"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateBookingOutput",
  "type": "object"
}

delete_booking — Cancel an existing booking by its UID

Parameters

string

required

The UID of the booking to cancel

string

The reason for cancelling the booking

boolean

Whether to cancel all subsequent occurrences of a recurring booking

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Status"
    }
  },
  "required": [
    "success"
  ],
  "title": "DeleteBookingOutput",
  "type": "object"
}

get_all_bookings — Retrieve all bookings from Cal.com with optional filters

Parameters

integer

Maximum number of pages to fetch (1-500, default 50)

array

Filter by status: upcoming, recurring, past, cancelled, unconfirmed

string

Return bookings that start after this time (ISO 8601)

string

Return bookings that end before this time (ISO 8601)

string

Return bookings created after this time (ISO 8601)

string

Return bookings created before this time (ISO 8601)

string

Filter bookings by attendee email

string

Filter bookings by attendee name

string

Filter bookings by booking UID

integer

Filter bookings by event type ID

string

Sort bookings by start time: asc or desc

string

Sort bookings by end time: asc or desc

string

Sort bookings by creation time: asc or desc

Response

{
  "$defs": {
    "BookingItem": {
      "additionalProperties": false,
      "description": "A booking object returned by the Cal.com API.",
      "properties": {
        "uid": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Uid"
        },
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Title"
        },
        "status": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Status"
        },
        "start": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Start"
        },
        "end": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "End"
        },
        "attendees": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Attendees",
          "type": "array"
        },
        "hosts": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Hosts",
          "type": "array"
        },
        "event_type_id": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Event Type Id"
        },
        "meeting_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Meeting Url"
        },
        "location": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Location"
        }
      },
      "title": "BookingItem",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "bookings": {
      "items": {
        "$ref": "#/$defs/BookingItem"
      },
      "title": "Bookings",
      "type": "array"
    },
    "total": {
      "default": 0,
      "title": "Total",
      "type": "integer"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetAllBookingsOutput",
  "type": "object"
}

get_bookable_slots — Retrieve available bookable slots between a datetime range

Parameters

string

required

Start date/time in ISO 8601 format (UTC)

string

required

End date/time in ISO 8601 format (UTC)

integer

ID of the event type to get slots for

string

Slug of the event type (requires username or team_slug)

string

Username of the individual event owner

array

List of at least 2 usernames for a dynamic event

string

Slug of the team for team event type slot lookup

string

Organization slug for slug-based event type lookup

string

The time zone for the slot lookup

integer

Override the default slot duration in minutes

string

Response format: range (start and end) or time (start only)

string

UID of the booking being rescheduled to exclude from busy calculations

Response

{
  "$defs": {
    "GetBookableSlot": {
      "additionalProperties": false,
      "description": "A single available time slot.",
      "properties": {
        "time": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Time"
        },
        "start": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Start"
        },
        "end": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "End"
        }
      },
      "title": "GetBookableSlot",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "slots": {
      "additionalProperties": {
        "items": {
          "$ref": "#/$defs/GetBookableSlot"
        },
        "type": "array"
      },
      "title": "Slots",
      "type": "object"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetBookableSlotsOutput",
  "type": "object"
}

get_booking — Retrieve a booking by its UID

Parameters

string

required

The UID of the booking to retrieve

Response

{
  "$defs": {
    "BookingItem": {
      "additionalProperties": false,
      "description": "A booking object returned by the Cal.com API.",
      "properties": {
        "uid": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Uid"
        },
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Title"
        },
        "status": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Status"
        },
        "start": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Start"
        },
        "end": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "End"
        },
        "attendees": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Attendees",
          "type": "array"
        },
        "hosts": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Hosts",
          "type": "array"
        },
        "event_type_id": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Event Type Id"
        },
        "meeting_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Meeting Url"
        },
        "location": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Location"
        }
      },
      "title": "BookingItem",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Status"
    },
    "booking": {
      "anyOf": [
        {
          "$ref": "#/$defs/BookingItem"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "success"
  ],
  "title": "GetBookingOutput",
  "type": "object"
}

list_event_type_id_options — Retrieve available event types with their IDs

Response

{
  "$defs": {
    "EventTypeOption": {
      "additionalProperties": false,
      "description": "An event type with its ID and title.",
      "properties": {
        "label": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Label"
        },
        "value": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Value"
        }
      },
      "title": "EventTypeOption",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "event_types": {
      "items": {
        "$ref": "#/$defs/EventTypeOption"
      },
      "title": "Event Types",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListEventTypeIdOptionsOutput",
  "type": "object"
}

Using

Providers

Building

Tools

Cal.com Integration for AI Agents & Workflows

Overview

Authentication

API Key

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Response

Limits & Quotas

Calendly

Google Calendar

Luma

Links

​Overview

​Authentication

​API Key

​Required Credentials

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Response

​Limits & Quotas

​Related integrations

Calendly

Google Calendar

Luma

​Links

Overview

Authentication

API Key

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Response

Limits & Quotas

Related integrations

Links