Calendario

Lista calendarios de una conexión y luego crea, lee, actualiza y elimina eventos. Las horas son ISO 8601; incluye la zona horaria del evento para que el manejo de recurrencias y todo-el-día se mantenga correcto. Los enlaces de videollamada (Google Meet, Microsoft Teams) se solicitan por evento y se devuelven en el evento.

curl -X POST https://api.hora.to/v1/calendars/cal_primary/events \
  -H "Authorization: Bearer $HORATO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"connection_id":"conn_123","title":"Intro call","start":"2026-06-10T16:00:00Z","end":"2026-06-10T16:30:00Z","timezone":"America/Costa_Rica"}'

Consulta libre/ocupado en uno o varios calendarios, o pide slots reservables al motor de disponibilidad. La disponibilidad considera zona horaria del anfitrión, ventanas de trabajo, aviso mínimo y buffers, así que los slots son seguros de ofrecer a un invitado.

curl -X POST https://api.hora.to/v1/calendars/freebusy/query \
  -H "Authorization: Bearer $HORATO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"connection_id":"conn_123","calendar_ids":["primary"],"from":"2026-06-10T00:00:00Z","to":"2026-06-11T00:00:00Z"}'

Responde invitaciones (aceptar, tentativo, rechazar) y la respuesta se propaga al proveedor. Solicita un enlace de videollamada en un evento para que las reuniones creadas con Horato lleven una URL para unirse.

Cuando una cuenta no tiene calendario de Google, Microsoft o Apple, crea un calendario virtual nativo de Horato. Se activa de inmediato sin OAuth, se comporta como cualquier otra conexión de calendario y es un destino de primera clase para agendamiento y grabación: reservas, recordatorios y notetakers funcionan sobre él.

Créalo conectando el proveedor `virtual`; se aprovisiona un calendario virtual por defecto automáticamente.

curl -X POST https://api.hora.to/v1/connections \
  -H "Authorization: Bearer $HORATO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"virtual"}'