Get Cal.com Available Slots

Lists open booking slots for a Cal.com event type.

Unverified

What the model is told

Check which times are free before booking. Ask the customer for the dates they want and pass them as UTC ISO 8601 dates. Offer a few of the returned slots in the customer's time zone. Use the exact start value when booking.

Request

GEThttps://api.cal.com/v2/slots?eventTypeId={{eventTypeId}}&start={{startDate}}&end={{endDate}}&timeZone={{timeZone}}

Headers

cal-api-version2024-09-04
AuthorizationBearer YOUR_CAL_API_KEY

Parameters

eventTypeId stringThe numeric ID of the Cal.com event type.
startDate stringStart of the range, a date or UTC ISO 8601 time.
endDate stringEnd of the range, a date or UTC ISO 8601 time.
timeZone stringIANA time zone to return the slots in.

Engage payload

{
  "source": "VOICE_AI",
  "tool": {
    "id": "f8dc1bf9-e623-4476-a2aa-978e72dac108",
    "type": "HTTP_REQUEST",
    "label": "Get Cal.com Available Slots",
    "name": "get_cal_com_available_slots",
    "customName": false,
    "description": "Check which times are free before booking. Ask the customer for the dates they want and pass them as UTC ISO 8601 dates. Offer a few of the returned slots in the customer's time zone. Use the exact start value when booking.",
    "parameters": [
      {
        "name": "eventTypeId",
        "type": "string",
        "description": "The numeric ID of the Cal.com event type."
      },
      {
        "name": "startDate",
        "type": "string",
        "description": "Start of the range, a date or UTC ISO 8601 time."
      },
      {
        "name": "endDate",
        "type": "string",
        "description": "End of the range, a date or UTC ISO 8601 time."
      },
      {
        "name": "timeZone",
        "type": "string",
        "description": "IANA time zone to return the slots in."
      }
    ],
    "config": {
      "endpoint": {
        "method": "GET",
        "url": "https://api.cal.com/v2/slots?eventTypeId={{eventTypeId}}&start={{startDate}}&end={{endDate}}&timeZone={{timeZone}}"
      },
      "headers": [
        {
          "name": "cal-api-version",
          "value": "2024-09-04"
        },
        {
          "name": "Authorization",
          "value": "Bearer YOUR_CAL_API_KEY"
        }
      ],
      "body": null,
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.