v1

latestOpenAPI 3.0.02026-07-17121287546.7 KB
Cal Unified Calendars

List events for a connection

List events in a date range for a specific calendar connection. Only supported for Google Calendar connections; other connection types return 400.

get/v2/calendars/connections/{connectionId}/events

Path parameters

connectionIdstring required

Calendar connection ID from GET /connections

Query parameters

fromstring required
Example:2026-03-01

Start of the date range (ISO 8601 date or date-time)

tostring required
Example:2026-03-31

End of the date range (ISO 8601 date or date-time)

timeZonestring

IANA time zone for the request (e.g. America/New_York)

calendarIdstring

Calendar ID. Use 'primary' for the user's primary calendar, or the external ID of a connected calendar.

Headers

Authorizationstring required

value must be Bearer <token> where <token> is api key prefixed with cal_ or managed user access token

Response

status'success' | 'error' required

Example response

{
  "status": "success"
}