Lister les créneaux libres d'un type d'événement avec l'API Calendly
Liste les heures de début libres d'un type d'événement sur une plage allant jusqu'à 31 jours dans le futur. Chaque élément a start_time en UTC, invitees_remaining et scheduling_url. Il n'y a pas de pagination : demandez une plage plus courte si besoin.
- Identifiant
- calendly_list_event_type_available_times
L'appel
POST https://connect.reportei.com/api/tools/calendly_list_event_type_available_times/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"event_type": "<event_type>",
"start_time": "<start_time>",
"end_time": "<end_time>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| event_type | string | Oui | URI of the event type: the uri from List event types. |
| start_time | string | Oui | Start of the range, in UTC, such as 2026-11-02T00:00:00Z. It cannot be in the past. |
| end_time | string | Oui | End of the range, in UTC, in the future and at most 31 days after start_time. |
Connexions possibles
Votre client connecte son compte Calendly une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/calendly, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/calendly_list_event_type_available_times. Il devient la définition de tool de votre agent sans conversion.
Autres tools Calendly
- Obtenir l'utilisateur actuelGETRenvoie l'utilisateur Calendly connecté : uri, l'URI de l'utilisateur que demandent Lister les types d'événement, Lister les événements planifiés et Créer un type d'événement, et current_organization, l'URI de l'organisation, avec name, email, scheduling_url et timezone.
- Lister les types d'événementGETListe les types d'événement d'un utilisateur ou d'une organisation : envoyez user ou organization. Chaque élément a uri, name, duration en minutes, scheduling_url et active. La réponse contient collection et pagination : passez pagination.next_page_token comme page_token pour lire la page suivante.
- Obtenir un type d'événementGETRenvoie un type d'événement, avec name, duration en minutes, duration_options, locations, custom_questions (les questions de réservation auxquelles répond Créer un invité d'événement), scheduling_url et active.
- Créer un type d'événementPOSTCrée un type d'événement individuel (one-on-one) pour un utilisateur et le renvoie. Seul ce type (solo) peut être créé par l'API, et il est créé inactif sauf si active vaut true.
- Modifier un type d'événementPATCHModifie un type d'événement individuel et le renvoie. Seuls les champs envoyés changent. Seuls les types d'événement de type solo peuvent être modifiés par l'API.
- Lister les événements planifiésGETListe les réunions planifiées d'un utilisateur ou d'une organisation : envoyez user ou organization. Chaque élément a uri, name, status, start_time et end_time en UTC, event_type et invitees_counter. La réponse contient collection et pagination : passez pagination.next_page_token comme page_token pour lire la page suivante.
- Obtenir un événement planifiéGETRenvoie une réunion planifiée, avec name, status, start_time et end_time en UTC, event_type, location, invitees_counter, event_memberships (les hôtes) et, si elle a été annulée, cancellation.
- Annuler un événement planifiéPOSTAnnule une réunion planifiée pour tous ses invités et renvoie l'annulation. Un événement de groupe est annulé en entier : on ne peut pas annuler un seul invité d'un événement de groupe par l'API.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
