List calendar events
List synced calendar events overlapping the requested time range for the authenticated user. Standard users see only their own events; admin and consulting users may also see authorized teammate events. Optional filters (search, participantEmail, participantDomain, ownerUserId, hasExternalParticipant) AND together and are applied in SQL before limit. Results are oldest-first by default; for “most recent X meeting” use order=desc, a recent start/end window, a small limit, and search or participantDomain — take the first match. Requires a user-backed token (API key or OAuth authorization-code session).
Authorizations
Partner OAuth2 flows for integration API access tokens. Claude MCP custom connectors use authorization code with PKCE S256.
- Authorization URL
- /api/v1/oauth/authorize
- Token URL
- /api/v1/oauth/token
- Token URL
- /api/v1/oauth/token
Headers
Active organization UUID. Required for authenticated requests when the principal has access to multiple organizations.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$Query Parameters
Read-only convenience alias for X-Organization-Id. Legacy subscriberId query param is also accepted.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$Range start (inclusive) as ISO-8601 date-time.
Range end (inclusive) as ISO-8601 date-time. Must be >= start.
Maximum events to return (default 200, max 2000).
1 <= x <= 2000Sort by start time. Use desc for most-recent-first agent queries; asc (default) matches calendar views.
asc, desc Case-insensitive substring match on title, location, or description (e.g. QuotaPath or Weekly Co-Sell).
1 - 200Exact participant or organizer email (case-insensitive), e.g. graham@quotapath.com.
320Participant or organizer email domain host only (e.g. quotapath.com). Leading @ is stripped.
1 - 255Restrict to events owned by this user UUID (viewer or an authorized teammate from teamUserIds).
When true, only events with at least one participant/organizer outside the organization internal domain. When false, only events with no external participants.