WarmablyWarmablyDOCS
Search docs⌘K
Dashboard
API Reference/Endpoints

List all calendars

GET/api/linkedin/gateway/calendars

Lists every calendar a connected account can see, including shared and read-only ones, not just its primary calendar.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.

Query parameters

FieldTypeDescription
account_id *stringThe connected account whose calendars to list.
cursorstringPagination cursor from a previous page's next_cursor.
offsetnumberAn offset-based alternative to cursor, on providers that support it.
limitnumberPage size.

Response fields

FieldTypeDescription
dataarrayEach calendar: id, name, description, is_read_only, is_owned_by_user, is_default, is_primary, access_role, background_color, foreground_color, sync_activated and timezone.
next_cursorstringPass as cursor on the next call to page forward.

Errors

·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. The account_id doesn't belong to this key.
CredentialsRequired
AuthorizationBearer wm_live_••••••••
RequestTry it
curl "https://api.warmably.com/api/linkedin/gateway/calendars?account_id=459993d2-b0e7-4b19-baf9-45252ca324cf" \
  -H "Authorization: Bearer wm_live_..."
Response
200 OK
{
  "data": [
    {
      "object": "Calendar",
      "id": "c5a2f918-3e6b-4d70-8a19-2f7c6e1b9d40",
      "name": "Priya Shah",
      "is_read_only": false,
      "is_owned_by_user": true,
      "is_primary": true,
      "access_role": "owner",
      "background_color": "#4285f4",
      "timezone": "America/New_York"
    }
  ],
  "next_cursor": null
}
No key yet? Create one from Dashboard → API Keys.