---
title: "List calendar connections"
method: GET
path: "/v2/calendars/connections"
tags: ["Cal Unified Calendars"]
---

# List calendar connections

`GET /v2/calendars/connections`

Returns all calendar connections for the authenticated user (Google, Office 365, Apple). Use connectionId in connection-scoped endpoints. Note: Event CRUD (list/create/get/update/delete events) is currently only supported for Google Calendar connections; other types will return 400.

## Headers

- `Authorization` string, required

## Response `200`

- ListConnectionsOutput
  - `status` 'success' | 'error', required
  - `data` ListConnectionsData, required
    - `connections` CalendarConnectionItem[], required
      - `connectionId` string, required — Stable ID for this calendar connection (use in connection-scoped endpoints)
      - `type` 'google' | 'office365' | 'apple', required — Calendar provider type
      - `email` string, nullable — Primary email for this connection (null if unavailable)

---

[API](https://skmtc.net/calcom/apis/cal-diy-api-v2.md) · [All operations](https://skmtc.net/calcom/apis/cal-diy-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/calcom/cal-diy-api-v2/versions/16de9d3eb7b3/schema)