Tools de Calendly
Las 12 operaciones de Calendly que tu producto ejecuta en la cuenta de tu cliente con Connect. Todas usan el mismo endpoint, POST /api/tools/{tool}/execute.
- 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.
- Cancelar evento programadoPOSTCancela una reunión programada para todos sus invitados y devuelve la cancelación. Un evento grupal se cancela completo: no se puede cancelar un solo invitado de un evento grupal por la API.
- Listar invitados del eventoGETLista los invitados de una reunión programada, con name, email, status, questions_and_answers, tracking (los parámetros UTM de la reserva), no_show, cancel_url y reschedule_url. La respuesta tiene collection y pagination: pasa pagination.next_page_token como page_token para leer la página siguiente.
- Crear invitado del eventoPOSTAgenda 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.
- Crear enlace de agendamientoPOSTCrea un enlace de agendamiento de un solo uso para un tipo de evento y devuelve su booking_url, para enviarlo a una sola persona. El enlace sirve para una reserva, y un enlace sin usar vence a los 90 días.
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.
