DevelopersAPI Reference
Calendar
List and create events on a user's calendar.
Calendar
Both operations require X-User-Email and the calendar permission. Events belong to that user.
List events
GET /api/v1/calendar
| Query | Description |
|---|---|
startDate | Include events that end on or after this instant |
endDate | Include events that start on or before this instant |
limit / offset | Pagination |
data.events[] includes title, description, location, start/end, allDay, color, recurrence fields, and reminderMinutes.
Create an event
POST /api/v1/calendar returns 201.
| Field | Required | Notes |
|---|---|---|
title | Yes | 1–200 characters |
startTime | Yes | ISO 8601 datetime |
endTime | Yes | Must be after startTime |
description | No | Max 5000 |
location | No | Max 500 |
allDay | No | Default false |
color | No | |
reminderMinutes | No | 0–10080 (one week) |
INVALID_DATES (400) if the end is not after the start.