Skip to content

Calendars on the connected account's list, with access role.

Returns the calendars on the user's calendar list.

Job calendar.calendars.list

Your AI asks

choose input values first
telipot inspect google-calendar.calendars.list

Provider's rate

Free
Inspect· before choosing inputs

google-calendar.calendars.list

FreePerson’s own

Whose account it uses

1The person asking · as Ana
Selected identity for this example
2Your company’s Google Calendar account
skipped
3Our account
not used

Choose inputs

minAccessRole · Keep only calendars the user holds at least this role on

maxResults · Entries on one page

No complete example input is recorded. Inspect reads the schema; it does not run the task.

What it costs

Free

no charge from the provider

For developers · inspect first

Read the schema and choose input values

telipot inspect google-calendar.calendars.list

No complete example input is recorded. Read the field notes below before building the call.

minAccessRole

string · one of "freeBusyReader", "reader", "writer", "writerWithoutPrivateAccess", "owner"

Keep only calendars the user holds at least this role on

maxResults

integer · 1 to 250 · default 100

Entries on one page

pageToken

string

The nextPageToken of the previous page

showDeleted

boolean · default false

Whether to include entries deleted from the list

showHidden

boolean · default false

Whether to include entries hidden from the list

items

object[]

nextPageToken

string

Absent on the last page

nextSyncToken

string

etag

string

kind

string

Full output schema · JSONNested fields and constraints

Output JSON Schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The calendar id; for a user's own calendar it is an address"
          },
          "summary": {
            "type": "string"
          },
          "summaryOverride": {
            "type": "string",
            "description": "The title the user gave it"
          },
          "description": {
            "type": "string"
          },
          "timeZone": {
            "type": "string"
          },
          "accessRole": {
            "type": "string",
            "description": "freeBusyReader, reader, writer or owner"
          },
          "primary": {
            "type": "boolean",
            "description": "True for the user's own calendar"
          },
          "selected": {
            "type": "boolean"
          },
          "hidden": {
            "type": "boolean"
          },
          "deleted": {
            "type": "boolean"
          },
          "backgroundColor": {
            "type": "string"
          },
          "foregroundColor": {
            "type": "string"
          },
          "colorId": {
            "type": "string"
          },
          "defaultReminders": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "method": {
                  "type": "string"
                },
                "minutes": {
                  "type": "integer"
                }
              }
            }
          },
          "etag": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          }
        }
      }
    },
    "nextPageToken": {
      "type": "string",
      "description": "Absent on the last page"
    },
    "nextSyncToken": {
      "type": "string"
    },
    "etag": {
      "type": "string"
    },
    "kind": {
      "type": "string"
    }
  }
}

A real answer

examples/google-calendar.calendars.list.json

{
  "kind": "calendar#calendarList",
  "etag": "\"EXAMPLEETAG\"",
  "items": [
    {
      "kind": "calendar#calendarListEntry",
      "etag": "\"EXAMPLEETAG\"",
      "id": "contact@example.com",
      "summary": "contact@example.com",
      "timeZone": "America/Los_Angeles",
      "accessRole": "owner",
      "primary": true,
      "selected": true,
      "backgroundColor": "#9fe1e7",
      "foregroundColor": "#000000",
      "colorId": "14",
      "defaultReminders": [
        {
          "method": "popup",
          "minutes": 10
        }
      ]
    },
    {
      "kind": "calendar#calendarListEntry",
      "etag": "\"EXAMPLEETAG\"",
      "id": "team@example.com",
      "summary": "Team",
      "timeZone": "America/Los_Angeles",
      "accessRole": "reader",
      "backgroundColor": "#cabdbf",
      "foregroundColor": "#000000",
      "colorId": "8"
    }
  ]
}