API reference
Calendar
Events and free/busy time.
Base URL https://api.pinal.tech/v1
API reference
Events and free/busy time.
Base URL https://api.pinal.tech/v1
/calendar/freebusyBusy blocks across all calendars, with no event details.
from string (date-time) requiredStart (RFC 3339).
to string (date-time) requiredEnd (RFC 3339).
curl "https://api.pinal.tech/v1/calendar/freebusy?from=%7Bfrom%7D&to=%7Bto%7D" \
-H "Authorization: Bearer $ACCESS_TOKEN"{
"busy": [
{
"start": "2026-11-19T15:20:04Z",
"end": "2026-11-19T15:20:04Z"
}
]
}/calendar/eventsEvents in a time range, expanded from recurrences.
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.
curl "https://api.pinal.tech/v1/calendar/events" \
-H "Authorization: Bearer $ACCESS_TOKEN"{
"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"
}/calendar/eventsCreates an event and, if it has attendees, sends invitations from the person.
id string read-onlycalendar 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.
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"
}'{
"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"
}