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.
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.