Calendar

The API only touches the calendar called Paper, which the app itself creates in the person's Google Calendar. Their other calendars stay out of reach.

Before using it:

1. The person connects Google Calendar in Settings → Integrations.
2. In Settings → Developer, they tap Allow the "Paper" calendar for the API.
3. The token needs the calendar permission. Secure tokens don't access the calendar.

Without the first two steps, the API answers 409.

List eventsCopy Anchor Link

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

from and to accept a date or a date and time in ISO 8601. Without from, it starts now. Without to, it goes 30 days past from. Returns up to 250 events, in order of start.

[
  {
    "id": "k9d8f7g6h5j4",
    "titulo": "Dentist",
    "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" }
  }
]

All-day events come with { "date": "2026-10-06" } in inicio and fim.

Create an eventCopy Anchor Link

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

{
  "title": "Deliver report",
  "date": "2026-10-08",
  "time": "09:30",
  "durationMinutes": 45,
  "description": "Final version, with the charts.",
  "timeZone": "America/New_York"
}

Response: { "id": "…" }. Needs the Read and create events permission.

Delete an eventCopy Anchor Link

DELETE /calendar/events/{id}

Only deletes events in the "Paper" calendar. Needs the Read and create events permission.

Common senseCopy Anchor Link

Create events the person asked for or that come from their notes. Don't fill the calendar with repeated reminders or use the calendar as a system's task queue.