Créer un invité d'événement avec l'API Calendly
Réserve une réunion sur un créneau libre d'un type d'événement et renvoie l'invité, avec event (l'URI de l'événement planifié), cancel_url et reschedule_url. Calendly envoie les confirmations et invitations de calendrier comme lorsque l'invité réserve sur la page de planification. Seuls les utilisateurs d'un plan payant peuvent réserver par l'API : le plan Free reçoit 403.
- Identifiant
- calendly_create_event_invitee
L'appel
POST https://connect.reportei.com/api/tools/calendly_create_event_invitee/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>",
"invitee": {}
}
}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 meeting in UTC, such as 2026-11-05T18:30:00Z: one of the start_time values from List event type available times. |
| invitee | object | Oui | The person who books the meeting. Send name, or first_name and last_name. |
| location | object | Non | Where the meeting happens: one of the locations of the event type, from Get event type. Required when the event type has a location, and left out when it has none or uses round robin. |
| questions_and_answers | array | Non | Answers to the booking questions, which are the custom_questions of the event type, from Get event type. Every required question must be answered. |
| tracking | object | Non | UTM parameters to store with the booking. They come back in the tracking of the invitee. |
| event_guests | array | Non | Email addresses of up to 10 guests to invite to the meeting. |
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_create_event_invitee. 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 créneaux libres d'un type d'événementGETListe 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.
- 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.
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.
