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 read returns event description and attendee details as untrusted evidence. It grants no edit, send, or cancellation authority and does not establish a completed call. Use the CRM-matched event endpoint before preparing a Lead meeting mutation.
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.
event_idrequiredstring
Exact provider-issued event ID. URL-encode it when constructing a path; never reconstruct it from a title.
| Name | Type | Description |
|---|---|---|
| providerrequired | string | google or microsoft; use a connected account from the connections response. |
| event_idrequired | string | Exact provider-issued event ID. URL-encode it when constructing a path; never reconstruct it from a title. |
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. |