Agenda

La API solo toca la agenda llamada Paper, que la propia app crea en el Google Calendar de la persona. Sus otras agendas quedan fuera de alcance.

Antes de usarla:

1. La persona conecta Google Calendar en Configuración → Integraciones.
2. En Configuración → Desarrollador, toca Habilitar la agenda "Paper" para la API.
3. El token necesita el permiso de agenda. Los tokens seguros no acceden a la agenda.

Sin los dos primeros pasos, la API responde 409.

Listar eventosCopiar enlace de la sección

GET /calendar/events?from=2026-10-01&to=2026-10-31

from y to aceptan una fecha o una fecha y hora en ISO 8601. Sin from, empieza ahora. Sin to, llega hasta 30 días después de from. Devuelve hasta 250 eventos, en orden de inicio.

[
  {
    "id": "k9d8f7g6h5j4",
    "titulo": "Dentista",
    "descricao": null,
    "inicio": { "dateTime": "2026-10-06T14:00:00-03:00", "timeZone": "America/Sao_Paulo" },
    "fim": { "dateTime": "2026-10-06T15:00:00-03:00", "timeZone": "America/Sao_Paulo" }
  }
]

Los eventos de día completo vienen con { "date": "2026-10-06" } en inicio y fim.

Crear un eventoCopiar enlace de la sección

POST /calendar/events
Content-Type: application/json

{
  "title": "Entregar informe",
  "date": "2026-10-08",
  "time": "09:30",
  "durationMinutes": 45,
  "description": "Versión final, con los gráficos.",
  "timeZone": "America/Argentina/Buenos_Aires"
}

Respuesta: { "id": "…" }. Necesita el permiso Leer y crear eventos.

Borrar un eventoCopiar enlace de la sección

DELETE /calendar/events/{id}

Solo borra eventos de la agenda "Paper". Necesita el permiso Leer y crear eventos.

Sentido comúnCopiar enlace de la sección

Crea eventos que la persona pidió o que vienen de sus notas. No llenes la agenda con recordatorios repetidos ni uses la agenda como cola de tareas de un sistema.