Crear invitado del evento en Calendly, con una API
Agenda una reunión en un horario libre de un tipo de evento y devuelve el invitado, con event (la URI del evento programado), cancel_url y reschedule_url. Calendly envía las confirmaciones e invitaciones de calendario como cuando el invitado reserva en la página de agendamiento. Solo los usuarios de plan de pago pueden agendar por la API: el plan Free recibe 403.
- Identificador
- calendly_create_event_invitee
La llamada
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": {}
}
}Tu sistema envía el id de la conexión de tu cliente y los argumentos de la tool. Los headers son los mismos de toda la API de Connect: el token de tu producto y el token de tu cliente.
Parámetros
Las descripciones de los parámetros siguen la documentación oficial de la app, en inglés.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| event_type | string | Sí | URI of the event type: the uri from List event types. |
| start_time | string | Sí | Start of the meeting in UTC, such as 2026-11-05T18:30:00Z: one of the start_time values from List event type available times. |
| invitee | object | Sí | The person who books the meeting. Send name, or first_name and last_name. |
| location | object | No | Where 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_answers | array | No | Answers to the booking questions, which are the custom_questions of the event type, from Get event type. Every required question must be answered. |
| tracking | object | No | UTM parameters to store with the booking. They come back in the tracking of the invitee. |
| event_guests | array | No | Email addresses of up to 10 guests to invite to the meeting. |
Conexiones posibles
Tu cliente conecta su cuenta de Calendly una sola vez, con uno de los modos de abajo. La misma conexión sirve para todas las tools del toolkit.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/calendly, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
La respuesta
Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app. Los errores HTTP devueltos por la app usan el objeto {error, api_error}; la autenticación o validación pueden fallar antes de la ejecución. El header X-Toolkit-Execution-Id identifica la ejecución registrada, disponible en GET /api/tools/executions/{uuid}.
Lista para agentes de IA
El input de esta tool es un JSON Schema, disponible en GET /api/tools/calendly_create_event_invitee. Se convierte en la definición de tool de tu agente sin conversión.
Otras tools de Calendly
- Obtener usuario actualGETDevuelve el usuario de Calendly conectado: uri, la URI del usuario que piden Listar tipos de evento, Listar eventos programados y Crear tipo de evento, y current_organization, la URI de la organización, con name, email, scheduling_url y timezone.
- Listar tipos de eventoGETLista los tipos de evento de un usuario o de una organización: envía user u organization. Cada elemento tiene uri, name, duration en minutos, scheduling_url y active. La respuesta tiene collection y pagination: pasa pagination.next_page_token como page_token para leer la página siguiente.
- Obtener tipo de eventoGETDevuelve un tipo de evento, con name, duration en minutos, duration_options, locations, custom_questions (las preguntas de reserva que responde Crear invitado del evento), scheduling_url y active.
- Crear tipo de eventoPOSTCrea un tipo de evento individual (one-on-one) para un usuario y lo devuelve. Solo este tipo (solo) se puede crear por la API, y se crea inactivo salvo que active sea true.
- Actualizar tipo de eventoPATCHActualiza un tipo de evento individual y lo devuelve. Solo cambian los campos enviados. Solo los tipos de evento de tipo solo se pueden actualizar por la API.
- Listar horarios libres del tipo de eventoGETLista los horarios de inicio libres de un tipo de evento en un rango de hasta 31 días a futuro. Cada elemento tiene start_time en UTC, invitees_remaining y scheduling_url. No hay paginación: pide un rango más corto cuando haga falta.
- Listar eventos programadosGETLista las reuniones programadas de un usuario o de una organización: envía user u organization. Cada elemento tiene uri, name, status, start_time y end_time en UTC, event_type e invitees_counter. La respuesta tiene collection y pagination: pasa pagination.next_page_token como page_token para leer la página siguiente.
- Obtener evento programadoGETDevuelve una reunión programada, con name, status, start_time y end_time en UTC, event_type, location, invitees_counter, event_memberships (los anfitriones) y, si fue cancelada, cancellation.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
