Tools Calendly
Les 12 opérations Calendly que votre produit exécute sur le compte de votre client via Connect. Elles utilisent toutes le même endpoint, POST /api/tools/{tool}/execute.
- 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.
- 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.
- Lister les invités d'un événementGETListe les invités d'une réunion planifiée, avec name, email, status, questions_and_answers, tracking (les paramètres UTM de la réservation), no_show, cancel_url et reschedule_url. La réponse contient collection et pagination : passez pagination.next_page_token comme page_token pour lire la page suivante.
- Créer un invité d'événementPOSTRé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.
- Créer un lien de planificationPOSTCrée un lien de planification à usage unique pour un type d'événement et renvoie son booking_url, à envoyer à une seule personne. Le lien vaut pour une réservation, et un lien non utilisé expire au bout de 90 jours.
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.
