
Créer une réunion avec l'API Zoom
Planifie une réunion pour un utilisateur et la renvoie avec join_url et start_url. Zoom accepte jusqu'à 100 de ces appels par jour et par hôte.
- Identifiant
- zoom_create_meeting
L'appel
POST https://connect.reportei.com/api/tools/zoom_create_meeting/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"userId": "<userId>"
}
}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 |
|---|---|---|---|
| userId | string | Oui | me for the connected user. |
| topic | string | Non | Topic of the meeting. |
| type | integer | Non | 2 scheduled, the default; 1 instant; 3 recurring with no fixed time; 8 recurring with a fixed time, which needs recurrence.Valeurs : 1, 2, 3, 8 |
| start_time | string | Non | Start in UTC, as 2026-03-31T12:00:00Z, or in local time, as 2026-03-31T09:00:00 together with timezone. A missing or past value means now. |
| duration | integer | Non | Duration in minutes. |
| timezone | string | Non | Time zone ID of start_time, for example America/Sao_Paulo. The default is the time zone of the account. |
| agenda | string | Non | Agenda of the meeting. |
| password | string | Non | Passcode of the meeting. When the account requires one and none is sent, Zoom generates it. |
| recurrence | object | Non | Repetition of a type 8 meeting. type is 1 daily, 2 weekly or 3 monthly. weekly_days is a comma-separated list where 1 is Sunday and 7 is Saturday. Use end_times or end_date_time, not both. |
| settings | object | Non | Meeting settings. approval_type 0 or 1 turns registration on, with automatic or manual approval, and 2 turns it off. Other settings of the Zoom reference also work. |
Connexions possibles
Votre client connecte son compte Zoom 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/zoom, 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/zoom_create_meeting. Il devient la définition de tool de votre agent sans conversion.
Autres tools Zoom
- Obtenir un utilisateurGETRenvoie le profil d'un utilisateur : nom, email, fuseau horaire, ID de réunion personnelle et type de forfait.
- Lister les réunionsGETListe les réunions planifiées d'un utilisateur ; les réunions instantanées ne sont pas incluses. La réponse contient meetings et next_page_token : passez next_page_token pour lire la page suivante.
- Obtenir une réunionGETRenvoie une réunion avec join_url, start_url, paramètres et, pour une réunion récurrente, ses occurrences. Le start_url expire au bout de deux heures : relisez-le ici quand nécessaire.
- Mettre à jour une réunionPATCHMet à jour une réunion ; seuls les champs envoyés changent. Avec occurrence_id, modifie une occurrence d'une réunion récurrente. Zoom accepte jusqu'à 100 mises à jour par jour et par réunion.
- Supprimer une réunionDELETESupprime une réunion. Sans occurrence_id, une réunion récurrente est supprimée avec toutes ses occurrences.
- Obtenir l'invitation d'une réunionGETRenvoie le texte d'invitation d'une réunion, avec le lien et les informations d'appel, prêt à envoyer aux invités.
- Lister les inscrits d'une réunionGETListe les inscrits d'une réunion dont l'inscription est activée. Seuls les inscrits approuvés reviennent, sauf indication contraire de status. Nécessite un forfait Pro ou supérieur. Passez next_page_token pour lire la page suivante.
- Inscrire un participant à la réunionPOSTInscrit une personne à une réunion dont l'inscription est activée et renvoie le registrant_id et le join_url personnel. Zoom peut envoyer un email à l'inscrit, selon les paramètres de la réunion.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
