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.