Skip to content

Google Calendar: List Calendars

Plugin ID: eca_google_calendar_list_calendars

Available since: 1.0.0

Retrieves all calendars accessible to the authenticated user with filtering options for access roles, visibility, and pagination.

Fields

Authentication Type — config key: auth_type

Choose between API Client (OAuth2) or Service Account authentication.

Type: select · Required: yes · Default: api_client

Allowed values: api_client, service_account

Authentication Source — config key: auth_from

Choose whether to select authentication directly or use a token for dynamic selection.

Type: select · Required: yes · Default: direct

Allowed values: direct, token

API Client — config key: api_client_id

Search and select an API Client for OAuth2 authentication.

Type: textfield · Required: no · Default: empty string

Service Account — config key: service_account_id

Search and select a Service Account for server-to-server authentication.

Type: textfield · Required: no · Default: empty string

Client ID from Token — config key: auth_client_from_token

Token that resolves to a client ID (e.g., [user:field_google_client_id]). The token should contain just the client ID, not the auth type prefix.
This field supports tokens.

Type: textfield · Required: no · Default: empty string

Maximum Results — config key: max_results

Maximum number of calendars to return (1-250).

Type: number · Required: yes · Default: 50

Minimum Access Role — config key: min_access_role

Filter calendars by minimum access role. Only calendars with this role or higher will be returned.

Type: select · Required: no · Default: empty string

Allowed values: '', freeBusyReader, reader, writer, owner

Include Deleted Calendars — config key: show_deleted

Whether to include deleted calendar entries in the result.

Type: checkbox · Required: no · Default: false

Include Hidden Calendars — config key: show_hidden

Whether to include hidden calendar entries in the result.

Type: checkbox · Required: no · Default: false

Calendars Token Name — config key: calendars_token_name

Token name to store the array of calendars. Accessible as [token_name:0:calendar_id], [token_name:1:summary], etc.
This field supports tokens.

Type: textfield · Required: no · Default: empty string

Count Token Name — config key: count_token_name

Token name to store the total number of calendars found.
This field supports tokens.

Type: textfield · Required: no · Default: empty string