---
title: "List Google Calendars"
api: "GET /v1/api/gcal/calendars"
description: "List the Google Calendars the connected account can write to."
lastUpdated: "2026-11-04"
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://trillet-ai.jamdesk.app/llms.txt). Append `.md` to any page URL for its markdown version.

Only calendars where the connected Google account is an **owner** or **writer** are returned. Read-only calendars are left out, because the agent can't book into them.

## Headers
<ParamField header="x-workspace-id" type="string" required>
Workspace identifier for the API. The call flow must belong to this workspace (or one of its sub-workspaces).
</ParamField>

## Query Parameters

<ParamField query="pathwayId" type="string" required>
The `_id` of the call flow that has the Google Calendar connection.
</ParamField>

## Response Fields

<ResponseField name="calendars" type="array">
The calendars the connected account can write to.

<Expandable title="properties">

<ResponseField name="id" type="string">
Calendar ID.
</ResponseField>

<ResponseField name="summary" type="string">
Calendar name.
</ResponseField>

<ResponseField name="description" type="string">
Calendar description (`""` if none).
</ResponseField>

<ResponseField name="primary" type="boolean">
Whether this is the account's primary calendar.
</ResponseField>

<ResponseField name="timeZone" type="string">
The calendar's IANA time zone (`""` if Google didn't return one).
</ResponseField>

</Expandable>
</ResponseField>

## Errors

| Status | Body | When |
| --- | --- | --- |
| `400` | `{"error": "pathwayId query parameter is required"}` | No `pathwayId` |
| `400` | `{"error": "Invalid pathwayId"}` | `pathwayId` isn't a valid ID |
| `403` | `{"error": "You do not have access to this workspace."}` | You aren't a member of the `x-workspace-id` workspace |
| `403` | `{"error": "Pathway does not belong to this workspace."}` | The flow belongs to another workspace |
| `404` | `{"error": "Pathway not found"}` | No call flow with that ID |
| `500` | `{"error": "Failed to refresh Google Calendar token"}` | The stored Google token could not be refreshed. Reconnect with [Install Google Calendar](https://trillet-ai.jamdesk.app/v1/api-reference/endpoints/integrations/google-calendar/install) |

<ResponseExample>
```json
{
  "calendars": [
    {
      "id": "jane@company.com",
      "summary": "Jane Doe",
      "description": "",
      "primary": true,
      "timeZone": "America/New_York"
    },
    {
      "id": "c_8f2e1a@group.calendar.google.com",
      "summary": "Appointments",
      "description": "Customer bookings",
      "primary": false,
      "timeZone": "America/New_York"
    }
  ]
}
```
</ResponseExample>


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://trillet-ai.jamdesk.app/api-specs.zip
