ChatGPT ↗
Claude ↗This page documents the canonical HTTP contract for this endpoint.
Conditional availability: these routes require CALENDAR_INTEGRATION_ENABLED=true; otherwise they return 404. Use a signed-in user session or a developer API key with the listed Calendar scope. Access uses the key owner’s own connected personal calendar in the current workspace. Calendar OAuth consent is separate from email consent. Credentials are never returned.
This endpoint returns up to 100 events with has_more and CRM match counts. It excludes unrelated personal events. Use the agenda endpoint for broader primary-calendar search and complete cursor traversal.
Command Center reads additionally respect CALENDAR_AGENT_READ_ENABLED; agent writes require CALENDAR_AGENT_ENABLED=true. HTTP and CLI availability do not by themselves prove that the harness adapter is enabled. Use capability discovery for the deployed surface.
Path parameters
providerrequiredstring
google or microsoft; use a connected account from the connections response.
| Name | Type | Description |
|---|---|---|
| providerrequired | string | google or microsoft; use a connected account from the connections response. |
Query parameters
startrequiredstring (date-time)
Inclusive start with a UTC offset. The requested range must be positive and at most 90 days.
endrequiredstring (date-time)
Exclusive end with a UTC offset, after start.
| Name | Type | Description |
|---|---|---|
| startrequired | string (date-time) | Inclusive start with a UTC offset. The requested range must be positive and at most 90 days. |
| endrequired | string (date-time) | Exclusive end with a UTC offset, after start. |
Errors
| Status | Meaning |
|---|---|
| 400 | Invalid range or provider state, reconnect required, CRM match missing, or event not editable. |
| 401 | Authentication required. |
| 403 | The key lacks the required Calendar scope. |
| 404 | Calendar is disabled, the connection is unavailable, or the event is not found. |
| 409 | Event version changed; read and review again. |
| 422 | Invalid request fields. |
| 502 | Calendar provider request failed. |