Skip to content

Google Calendar: Check Free/Busy

Plugin ID: eca_google_calendar_check_freebusy

Available since: 1.0.0

Queries availability for scheduling coordination by checking free/busy status across multiple calendars within a time range.

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

Start Time (From) — config key: time_min

Lower bound for free/busy query. For date range fields use [entity:field_date_range:start_date], for Smart Date fields use [entity:field_smart_date:value], for regular datetime fields use [entity:field_date:date]. Also supports string formats.
This field supports tokens.

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

End Time (Until) — config key: time_max

Upper bound for free/busy query. For date range fields use [entity:field_date_range:end_date], for Smart Date fields use [entity:field_smart_date:end_value], for regular datetime fields use [entity:field_date:date]. Also supports string formats.
This field supports tokens.

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

Calendar IDs — config key: calendar_ids

Calendar IDs to check, one per line. Use "primary" for the user's primary calendar. Can include tokens like [list_calendars:0:calendar_id].
This field supports tokens.

Type: textarea · Required: yes · Default: empty string

Free/Busy Token Name — config key: freebusy_token_name

Token name to store free/busy results. Accessible as [token_name:calendars:CALENDAR_ID:busy:0:start], [token_name:time_min], etc.
This field supports tokens.

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