Skip to main content

List calendar events

GET 
/calendar.list

List events from the authenticated user's connected calendars within a date range.

Pulls events from every active personal calendar attached to the user (e.g. Google, Microsoft) and merges them into a single chronological list. Canceled events are omitted.

Date range: Defaults to a 7-day window starting today (caller's timezone). Pass startDate to shift the window's start; pass endDate to set its end (inclusive). Both are interpreted as YYYY-MM-DD in the caller's timezone.

Access: Personal access only. Organization tokens do not have access to individual calendars and receive a 400.

Required scope: calendar:read

meetings:read also grants this endpoint, but only for API clients registered before 2026-07-29T00:00Z. Clients registered on or after that date must hold calendar:read, or the call fails with 403 / missing_scope. See Scopes.

OpenAPI Spec: chat-v1.json

Request​

Responses​

Calendar events retrieved successfully.