Criar convidado do evento no Calendly, por uma API

Agenda uma reunião em um horário livre de um tipo de evento e retorna o convidado, com event (a URI do evento agendado), cancel_url e reschedule_url. O Calendly envia as confirmações e convites de calendário como quando o convidado agenda na página de agendamento. Só usuários de plano pago podem agendar pela API: o plano Free recebe 403.

Identificador
calendly_create_event_invitee

A chamada

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

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "event_type": "<event_type>",
    "start_time": "<start_time>",
    "invitee": {}
  }
}

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
event_typestringSimURI of the event type: the uri from List event types.
start_timestringSimStart of the meeting in UTC, such as 2026-11-05T18:30:00Z: one of the start_time values from List event type available times.
inviteeobjectSimThe person who books the meeting. Send name, or first_name and last_name.
locationobjectNãoWhere the meeting happens: one of the locations of the event type, from Get event type. Required when the event type has a location, and left out when it has none or uses round robin.
questions_and_answersarrayNãoAnswers to the booking questions, which are the custom_questions of the event type, from Get event type. Every required question must be answered.
trackingobjectNãoUTM parameters to store with the booking. They come back in the tracking of the invitee.
event_guestsarrayNãoEmail addresses of up to 10 guests to invite to the meeting.

Conexões possíveis

O seu cliente conecta a conta do Calendly 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/calendly, 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/calendly_create_event_invitee. Ele vira a definição de tool do seu agente sem conversão.

Outras tools do Calendly

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.