---
title: "List calendar connections"
method: GET
path: "/v4/calendar-connections/connections"
tags: ["Calendar Connections V4"]
---

# List calendar connections

`GET /v4/calendar-connections/connections`

## Request

- Base URL: `https://developer.meetergo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.meetergo.com/v4/calendar-connections/connections`
- Auth: one of:
  - API key in header `x-meetergo-api-user-id`
  - HTTP bearer
  - HTTP bearer

Get all calendar connections for the authenticated user or a specific user (admin only). Returns connections from all providers (Google, Outlook).

## Query parameters

- `userId` string

## Response `200`

Calendar connections retrieved successfully

- object
  - `connections` object[]
    - `id` string
    - `provider` string
    - `email` string
    - `isPrimary` boolean
    - `isConnected` boolean
    - `primaryCalendar` string
    - `selectedCalendars` string[]
    - `validateAvailability` boolean
    - `cancelIfDeclinedOrDeleted` boolean
    - `disableAttendeeNotification` boolean
  - `total` number

## Other responses

- `400`: The request did not validate. `message` lists the constraints that failed.
- `401`: Missing, malformed, or expired credentials.
- `403`: Authenticated, but not allowed: the plan does not include this feature, or the token is scoped away from it.
- `429`: Rate limited. Back off and retry.

---

[API](https://skmtc.dev/meetergo/apis/meetergo-platform-api.md) · [All operations](https://skmtc.dev/meetergo/apis/meetergo-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meetergo/apis/meetergo-platform-api/revisions/b5d66cd8be67?raw)