Skip to main content
GET
Get calendar event

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}$

Path Parameters

eventId
string
required

Provider calendar event id (Nylas/Google/Microsoft event id).

Required string length: 1 - 512

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}$

Response

Calendar event detail.

id
string
required

Provider calendar event id.

title
string
required
start
string<date-time>
required

Event start time in UTC (ISO-8601).

end
string<date-time>
required

Event end time in UTC (ISO-8601).

allDay
boolean
required
readOnly
boolean
required

True when the caller cannot mutate the event. Standard users cannot edit provider read-only invitee copies or teammate calendars. Admins can edit shared standard-user calendars; consultants can edit any org calendar (write-through uses a writable organizer/teammate grant when needed).

calendarId
string | null
ownerUserId
string<uuid> | null

Organization user that owns the synced calendar grant for this event.

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}$
participantEmails
string<email>[] | null
organizerEmail
string<email> | null
participants
object[] | null
recurrence
string[] | null

RRULE / recurrence strings when present.

masterEventId
string | null
description
string | null
location
string | null
timezone
string | null

IANA timezone for timed events when available.

colorId
string | null