Google Calendar — Get calendars

Google Calendar — Get calendars

Type: googlecalendar-get-calendars  ·  Package: Google Calendar v1.0.5  ·  Output: List<Dictionary<string,object>>

Lists the calendars the account can access (the main one plus secondary or shared ones). Use it to find the id of a calendar other than primary (a room, a team, a shift calendar) before working on it.

How it works

Reads the session account’s calendar list: the calendars that show up in its Google Calendar. It returns a single page of results, up to 100 calendars. With a service account and no impersonateUser, the list only includes calendars added to that account.

Required parameters

None.

Optional parameters

Parameter	Type	Default	Description
session	ZoanGoogleCalendarSession	—	Session from Google Calendar — Connect. Inside Connect’s body it is inherited and you can leave it empty.

Output

Returns a List of Dictionary, one per calendar:

Key	Type	Content
id	string	Calendar ID; use it as calendarId.
summary	string	Calendar name.
description	string	Description (null if none).
primary	bool	true for the account’s main calendar.
accessRole	string	The account’s access: owner, writer, reader or freeBusyReader. To create or change events you need owner or writer.
timeZone	string	Calendar time zone (IANA), e.g. America/Bogota.

Common errors

Message	Cause and fix
No Google Calendar session available. Provide 'session' from a googlecalendar-connect activity, or place this activity inside the Connect activity's body …	The activity is outside Connect’s body and received no session. Move it inside the body or pass the saved session.
The service calendar has thrown an exception. HttpStatusCode is …	Google rejected the call: unknown calendar or event, no access, expired token or quota exceeded. See Google API errors.

Example

Find the “Support” calendar and create an event on it:

Google Calendar — Connect   credential = credential("calendar-team")
 └─ body:
      Google Calendar — Get calendars   → output: calendars
      For Each   items = calendars   itemVariable = cal
       └─ activities:
            If   condition = str(cal["summary"]) == "Support"
             └─ then:
                  Google Calendar — Create event   calendarId = cal["id"]   summary = "On-call shift"
                                                    start = "2026-06-20"   end = "2026-06-21"   allDay = true

Related activities

• Google Calendar — Get events — search events on a calendar.
• Google Calendar — Create event — create an event on a calendar.
• Google Calendar — Connect — open the session.
• All Google Calendar activities