iCalendlyDeveloper Docs
Calendars

GETGet All Calendars

Retrieve a list of all connected calendars for the authenticated user, organized by sub-provider integrations (e.g., Google Calendar, Microsoft Outlook, Apple Calendar) along with details for the active primary/destination calendar.

GET/v2/calendars
GET/v2/calendars

Header Parameters

AuthorizationRequiredstring

value must be Bearer <token> where <token> is api key prefixed with cal_ or managed user access token

curl -X GET "https://example.com/v2/calendars" \
  -H "Authorization: <string>"

{
  "status": "success",
  "data": {
    "connectedCalendars": [
      {
        "integration": {
          "appData": {},
          "dirName": "string",
          "__template": "string",
          "name": "string",
          "description": "string",
          "installed": true,
          "type": "string",
          "title": "string",
          "variant": "string",
          "category": "string",
          "categories": [
            "string"
          ],
          "logo": "string",
          "publisher": "string",
          "slug": "string",
          "url": "string",
          "email": "string",
          "locationOption": {}
        },
        "credentialId": 0,
        "delegationCredentialId": "string",
        "primary": {
          "externalId": "string",
          "integration": "string",
          "name": "string",
          "primary": true,
          "readOnly": true,
          "email": "string",
          "isSelected": true,
          "credentialId": 0,
          "delegationCredentialId": "string"
        },
        "calendars": [
          {
            "externalId": "string",
            "integration": "string",
            "name": "string",
            "primary": true,
            "readOnly": true,
            "email": "string",
            "isSelected": true,
            "credentialId": 0,
            "delegationCredentialId": "string"
          }
        ]
      }
    ],
    "destinationCalendar": {
      "id": {},
      "integration": "string",
      "externalId": "string",
      "primaryEmail": "string",
      "userId": 0,
      "eventTypeId": 0,
      "credentialId": 0,
      "delegationCredentialId": "string",
      "name": "string",
      "primary": true,
      "readOnly": true,
      "email": "string",
      "integrationTitle": "string"
    }
  }
}

Previous

Reserve a slot

Next

Get busy times