> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nedzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List calendars

> List the calendars or event types a connected calendar provider offers, to set up calendar actions.

<Note>
  This endpoint is for the VIP plan only. Other plans get a `403`. See [Plan access](/api-reference/introduction#plan-access).
</Note>

Use an `id` from this list as `calendarId` on a [calendar action](/api-reference/agents/actions#calendar). Connect the provider in the dashboard first.

## Query Parameters

<ParamField query="provider" type="string" required>
  `cal_com`, `calendly`, `leadconnector` or `google`.
</ParamField>

<ParamField query="workspaceId" type="string">
  Needed for an account API key.
</ParamField>

<ResponseExample>
  ```json Response theme={null}
  {
    "calendars": [
      { "id": "https://api.calendly.com/event_types/ABC", "name": "30 Minute Meeting", "owner": "personal" }
    ],
    "warnings": []
  }
  ```
</ResponseExample>

`warnings` says why the list may be incomplete, for example when the connected account cannot see every team calendar. It is empty when the list is complete.

## Errors

| Status | When |
| - | - |
| `400` | `provider` is missing or not one of the four. |
| `404` | The workspace is not in your API key's scope, or the provider is not connected. |
| `502` | The provider did not answer. Try again. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.