Lister les événements planifiés avec l'API Calendly

Liste 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.

Identifiant
calendly_list_scheduled_events

L'appel

POST https://connect.reportei.com/api/tools/calendly_list_scheduled_events/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "user": "<user>"
  }
}

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
userstringNonURI of a user: the uri from Get current user. Alone, it returns the events of the connected user. With organization, an owner or admin gets the events of that member.
organizationstringNonURI of the organization: the current_organization from Get current user. It returns the events of every member and needs an owner or admin of the organization.
invitee_emailstringNonOnly the events booked by this invitee email address.
statusstringNonOnly the active or only the canceled events.Valeurs : active, canceled
min_start_timestringNonOnly the events that start after this moment, in UTC, such as 2026-11-01T00:00:00Z.
max_start_timestringNonOnly the events that start before this moment, in UTC, such as 2026-11-30T23:59:59Z.
sortstringNonstart_time:asc or start_time:desc.
page_tokenstringNonThe pagination.next_page_token of the previous response, sent with the same filters.
countintegerNonEvents per page, up to 100. The default is 20.

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_scheduled_events. 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.