Modifier un type d'événement avec l'API Calendly
Modifie 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.
- Identifiant
- calendly_update_event_type
L'appel
POST https://connect.reportei.com/api/tools/calendly_update_event_type/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"uuid": "<uuid>"
}
}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 |
|---|---|---|---|
| uuid | string | Oui | UUID of the event type: the last segment of its uri, from List event types. |
| name | string | Non | Name of the event type, shown on the scheduling page. |
| description | string | Non | Description of the event type, shown on the scheduling page. |
| active | boolean | Non | true to make the event type bookable, false to turn it off. |
| duration | integer | Non | Length of the meetings in minutes, from 1 to 720. When duration_options is sent, it must be one of the options. |
| duration_options | array | Non | Up to 4 different lengths in minutes, each from 1 to 720, for the invitee to choose from. |
| locations | array | Non | Each place where the meeting can happen. The invitee chooses one when there is more than one. |
| color | string | Non | Color of the scheduling page, as a hexadecimal value in lowercase such as #1a73e8. |
| locale | string | Non | Language of the scheduling page.Valeurs : de, en, es, fr, it, nl, pt, uk |
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_update_event_type. 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.
- 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.
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.
