Pinal Developers

API reference

Calendar

Events and free/busy time.

Base URL https://api.pinal.tech/v1

Free/busy

GET /calendar/freebusy

Busy blocks across all calendars, with no event details.

Query parameters

  • from string (date-time) required

    Start (RFC 3339).

  • to string (date-time) required

    End (RFC 3339).

Responses

curl "https://api.pinal.tech/v1/calendar/freebusy?from=%7Bfrom%7D&to=%7Bto%7D" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
Response · 200
{
  "busy": [
    {
      "start": "2026-11-19T15:20:04Z",
      "end": "2026-11-19T15:20:04Z"
    }
  ]
}

List events

GET /calendar/events

Events in a time range, expanded from recurrences.

Query parameters

  • from string (date-time)

    Start (RFC 3339).

  • to string (date-time)

    End (RFC 3339).

  • calendar string

    Calendar ID.

  • limit integer

    Items per page, 1–100.

  • cursor string

    Opaque cursor from a previous page's next_cursor.

Responses

curl "https://api.pinal.tech/v1/calendar/events" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
Response · 200
{
  "events": [
    {
      "id": "string",
      "calendar": "string",
      "title": "string",
      "start": "2026-11-19T15:20:04Z",
      "end": "2026-11-19T15:20:04Z",
      "all_day": true,
      "location": "string",
      "notes": "string",
      "attendees": [
        {
          "name": "string",
          "email": "alex@pinal.email"
        }
      ],
      "recurrence": "string"
    }
  ],
  "next_cursor": "string"
}

Create an event

POST /calendar/events

Creates an event and, if it has attendees, sends invitations from the person.

Request body application/json

  • id string read-only
  • calendar string
  • title string required
  • start string (date-time) required
  • end string (date-time) required
  • all_day boolean
  • location string
  • notes string
  • attendees array of Address
  • recurrence string | null

    RFC 5545 RRULE.

Responses

curl -X POST "https://api.pinal.tech/v1/calendar/events" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Flatiron hike",
    "start": "2026-11-28T07:00:00-07:00",
    "end": "2026-11-28T13:00:00-07:00",
    "location": "Siphon Draw Trailhead"
  }'
Response · 201
{
  "id": "string",
  "calendar": "string",
  "title": "string",
  "start": "2026-11-19T15:20:04Z",
  "end": "2026-11-19T15:20:04Z",
  "all_day": true,
  "location": "string",
  "notes": "string",
  "attendees": [
    {
      "name": "string",
      "email": "alex@pinal.email"
    }
  ],
  "recurrence": "string"
}