Criar reunião no Zoom, por uma API

Agenda uma reunião para um usuário e a retorna com join_url e start_url. O Zoom aceita até 100 dessas chamadas por dia por anfitrião.

Identificador
zoom_create_meeting

A chamada

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>"
  }
}

Seu sistema envia o id da conexão do cliente e os argumentos da tool. Os headers são os mesmos de toda a API do Connect: o token do seu produto e o token do cliente.

Parâmetros

As descrições dos parâmetros seguem a documentação oficial do app, em inglês.

ParâmetroTipoObrigatórioDescrição
userIdstringSimme for the connected user.
topicstringNãoTopic of the meeting.
typeintegerNão2 scheduled, the default; 1 instant; 3 recurring with no fixed time; 8 recurring with a fixed time, which needs recurrence.Valores: 1, 2, 3, 8
start_timestringNãoStart 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.
durationintegerNãoDuration in minutes.
timezonestringNãoTime zone ID of start_time, for example America/Sao_Paulo. The default is the time zone of the account.
agendastringNãoAgenda of the meeting.
passwordstringNãoPasscode of the meeting. When the account requires one and none is sent, Zoom generates it.
recurrenceobjectNãoRepetition 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.
settingsobjectNãoMeeting 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.

Conexões possíveis

O seu cliente conecta a conta do Zoom uma vez, por um dos modos abaixo. A mesma conexão serve para todas as tools do toolkit.

OAuth com o app do seu produto

Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/zoom, e o cliente autoriza a conta numa tela de consentimento. O Connect renova o token quando ele está para vencer.

A resposta

Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app. Erros HTTP retornados pelo app usam o envelope {error, api_error}; falhas de autenticação ou validação podem ocorrer antes da execução. O header X-Toolkit-Execution-Id identifica a execução registrada, consultável em GET /api/tools/executions/{uuid}.

Pronta para agentes de IA

O input desta tool é um JSON Schema, disponível em GET /api/tools/zoom_create_meeting. Ele vira a definição de tool do seu agente sem conversão.

Outras tools do Zoom

Ver as 12 tools

Toolkits da mesma categoria

Ver os 100 toolkits

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.