Calendly

Get Calendly Available Times

Lists open booking slots for a Calendly event type.

Unverified

What the model is told

Check which times are free for an event type before booking. Ask the customer which dates suit them and pass a start and end in UTC (ISO 8601, ending in Z, in the future, no more than 31 days apart). Offer the customer a few of the returned start_time values, converted to their local time. Use the exact start_time when booking.

Request

GEThttps://api.calendly.com/event_type_available_times?event_type=https%3A%2F%2Fapi.calendly.com%2Fevent_types%2F{{eventTypeId}}&start_time={{startTime}}&end_time={{endTime}}

Headers

  • AuthorizationBearer YOUR_CALENDLY_PERSONAL_ACCESS_TOKEN

Parameters

  • eventTypeId stringThe UUID of the Calendly event type, the last part of its API URI.
  • startTime stringStart of the range in UTC, ISO 8601. Must not be in the past.
  • endTime stringEnd of the range in UTC, ISO 8601, at most 31 days after the start.

Engage payload

{
  "source": "VOICE_AI",
  "tool": {
    "id": "9a1b2db5-0abb-4d4f-b9b7-52042cdad6e0",
    "type": "HTTP_REQUEST",
    "label": "Get Calendly Available Times",
    "name": "get_calendly_available_times",
    "customName": false,
    "description": "Check which times are free for an event type before booking. Ask the customer which dates suit them and pass a start and end in UTC (ISO 8601, ending in Z, in the future, no more than 31 days apart). Offer the customer a few of the returned start_time values, converted to their local time. Use the exact start_time when booking.",
    "parameters": [
      {
        "name": "eventTypeId",
        "type": "string",
        "description": "The UUID of the Calendly event type, the last part of its API URI."
      },
      {
        "name": "startTime",
        "type": "string",
        "description": "Start of the range in UTC, ISO 8601. Must not be in the past."
      },
      {
        "name": "endTime",
        "type": "string",
        "description": "End of the range in UTC, ISO 8601, at most 31 days after the start."
      }
    ],
    "config": {
      "endpoint": {
        "method": "GET",
        "url": "https://api.calendly.com/event_type_available_times?event_type=https%3A%2F%2Fapi.calendly.com%2Fevent_types%2F{{eventTypeId}}&start_time={{startTime}}&end_time={{endTime}}"
      },
      "headers": [
        {
          "name": "Authorization",
          "value": "Bearer YOUR_CALENDLY_PERSONAL_ACCESS_TOKEN"
        }
      ],
      "body": null,
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.