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ètreTypeObligatoireDescription
event_typestringOuiURI of the event type: the uri from List event types.
start_timestringOuiStart of the meeting in UTC, such as 2026-11-05T18:30:00Z: one of the start_time values from List event type available times.
inviteeobjectOuiThe person who books the meeting. Send name, or first_name and last_name.
locationobjectNonWhere 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_answersarrayNonAnswers to the booking questions, which are the custom_questions of the event type, from Get event type. Every required question must be answered.
trackingobjectNonUTM parameters to store with the booking. They come back in the tracking of the invitee.
event_guestsarrayNonEmail 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

Voir les 12 tools

Toolkits de la même catégorie

Voir les 100 toolkits

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.