Skip to main content
GET
List calendar events

Authorizations

Authorization
string
header
required

Partner OAuth2 flows for integration API access tokens. Claude MCP custom connectors use authorization code with PKCE S256.

Headers

X-Organization-Id
string<uuid>

Active organization UUID. Required for authenticated requests when the principal has access to multiple organizations.

Pattern: ^[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

organizationId
string<uuid>

Read-only convenience alias for X-Organization-Id. Legacy subscriberId query param is also accepted.

Pattern: ^[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}$
start
string<date-time>
required

Range start (inclusive) as ISO-8601 date-time.

end
string<date-time>
required

Range end (inclusive) as ISO-8601 date-time. Must be >= start.

limit
integer
default:200

Maximum events to return (default 200, max 2000).

Required range: 1 <= x <= 2000
order
enum<string>
default:asc

Sort by start time. Use desc for most-recent-first agent queries; asc (default) matches calendar views.

Available options:
asc,
desc

Case-insensitive substring match on title, location, or description (e.g. QuotaPath or Weekly Co-Sell).

Required string length: 1 - 200
participantEmail
string<email>

Exact participant or organizer email (case-insensitive), e.g. graham@quotapath.com.

Maximum string length: 320
participantDomain
string

Participant or organizer email domain host only (e.g. quotapath.com). Leading @ is stripped.

Required string length: 1 - 255
ownerUserId
string<uuid>

Restrict to events owned by this user UUID (viewer or an authorized teammate from teamUserIds).

hasExternalParticipant
boolean

When true, only events with at least one participant/organizer outside the organization internal domain. When false, only events with no external participants.

Response

Calendar events in range.

events
object[]
required
teamUserIds
string<uuid>[]
required

Organization user ids whose teammate calendars are included for admin/consulting callers.

Pattern: ^[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}$