Skip to main content
Google Calendar logo
  • Category: scheduling & booking
  • Auth: OAUTH2
  • Composio-managed OAuth available? Yes
  • Tools: 50
  • Triggers: 7
  • Slug: GOOGLECALENDAR
  • Version: 20261103_00

Frequently Asked Questions

For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see How to create OAuth2 credentials for Google Apps.
The OAuth client is requesting scopes that Google hasn’t verified for that client. This usually happens when you add extra scopes beyond the defaults.Remove the additional scopes from your auth config, or create your own OAuth app and submit the scopes for verification. See How to create OAuth2 credentials for Google Apps.
When using custom OAuth credentials, the Google Calendar API must be enabled in the Google Cloud project that owns those credentials. Enable it in Google Cloud Console under APIs & Services, wait a few minutes, and retry.
The requested scopes are invalid or incorrectly formatted in the authorization URL. Verify your scope values against the Google OAuth scopes docs. If you’re creating auth configs programmatically, see the programmatic auth config guide.
The user’s access token is no longer valid. Common causes: the user revoked access, changed their password or 2FA, a Workspace admin policy changed, or Google’s refresh token limit (~50 per account) was exceeded. Re-authenticating the user typically resolves this.

Tools

Slug: GOOGLECALENDAR_ACL_DELETEDeletes an access control rule from a Google Calendar. Use when you need to remove sharing permissions for a user, group, or domain.

Input Parameters

string
required
ACL rule identifier.
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_ACL_GETRetrieves a specific access control rule for a calendar. Use when you need to check permissions for a specific user, group, or domain.

Input Parameters

string
required
ACL rule identifier. Format: ‘scope_type:scope_value’ or ‘default’. Valid scope types: ‘user’ (email), ‘group’ (group email), ‘domain’ (domain name), ‘default’ (public access). Examples: ‘user:john@example.com’, ‘group:team@example.com’, ‘domain:example.com’, ‘default’. Note: ‘me’ is NOT valid; use actual email/domain. The rule must exist - use GOOGLECALENDAR_LIST_ACL_RULES to find valid IDs.
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_ACL_INSERTCreates an access control rule for a calendar. Use when you need to grant sharing permissions to a user, group, or domain.

Input Parameters

string ("none" | "freeBusyReader" | "reader" | "writer" | "owner")
required
The role assigned to the scope. Possible values: “none” - Provides no access; “freeBusyReader” - Provides read access to free/busy information; “reader” - Provides read access to the calendar; “writer” - Provides read and write access to the calendar; “owner” - Provides ownership of the calendar.
object
required
The extent to which calendar access is granted by this ACL rule. Specifies who gets the access (user, group, domain, or default).
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.
boolean
Whether to send notifications about the calendar sharing change. Optional. The default is true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_ACL_LISTRetrieves the list of access control rules (ACLs) for a specified calendar, providing the necessary ‘rule_id’ values required for updating specific ACL rules.

Input Parameters

string
Token specifying which result page to return. Optional.
string
Token obtained from the nextSyncToken field returned on the last page of a previous list operation. It makes the result of this list operation contain only entries that have changed since then. Optional. The default is to retrieve all entries.
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.
integer
Maximum number of entries returned on one result page. Optional. The default is 100.
boolean
Whether to include deleted ACLs in the result. Optional. The default is False.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_ACL_PATCHPartially updates the role or scope of an existing Google Calendar access control rule. Provide at least one of role or scope; you can also choose whether to send sharing notifications. This operation modifies an existing rule rather than creating one.

Input Parameters

string
The role assigned to the scope. Possible values are: “none” - Provides no access; “freeBusyReader” - Provides read access to free/busy information; “reader” - Provides read access to the calendar (private events appear but details are hidden); “writer” - Provides read and write access to the calendar (private events and details are visible); “owner” - Provides ownership of the calendar (all permissions of writer plus ability to see and manipulate ACLs).
object
The extent to which calendar access is granted by this ACL rule. Optional for patch operations. Must include type (one of: ‘user’, ‘group’, ‘domain’, ‘default’) and value (email address or domain name) for all types except ‘default’.
string
required
ACL rule identifier of an existing rule. IMPORTANT: The rule must already exist on the calendar - this action cannot create new rules, only modify existing ones. Use the ACL list action to find existing rule IDs, or use the ACL insert action to create a new rule first. Format: ‘type:value’, such as ‘user:email@example.com’ or ‘group:group@example.com’.
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.
boolean
Whether to send notifications about the calendar sharing change. Note that there are no notifications on access removal. Optional. The default is True.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_ACL_UPDATEUpdates an access control rule for the specified calendar.

Input Parameters

string
required
The role assigned to the scope. Possible values are: - “none” - Provides no access. - “freeBusyReader” - Provides read access to free/busy information. - “reader” - Provides read access to the calendar. Private events will appear to users with reader access, but event details will be hidden. - “writer” - Provides read and write access to the calendar. Private events will appear to users with writer access, and event details will be visible. - “owner” - Provides ownership of the calendar. This role has all of the permissions of the writer role with the additional ability to see and manipulate ACLs.
string
required
ACL rule identifier.
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.
boolean
Whether to send notifications about the calendar sharing change. Note that there are no notifications on access removal. Optional. The default is True.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_ACL_WATCHTool to watch for changes to ACL resources. Use when you need to set up real-time notifications for access control list modifications on a calendar.

Input Parameters

string
required
A UUID or similar unique string that identifies this channel.
string
The type of delivery mechanism used for this channel. Valid values are “web_hook” or “webhook”.
string
An arbitrary string delivered to the target address with each notification delivered over this channel. Optional.
object
Additional parameters controlling delivery channel behavior. Optional.
string
required
The address where notifications are delivered for this channel.
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_BATCH_EVENTSExecute up to 1000 event mutations (create/patch/delete) in one Google Calendar HTTP batch request with per-item status/results. Use this to materially reduce round-trips for bulk operations like migrations, cleanup, or large-scale updates.

Input Parameters

boolean
If true, stop processing after the first batch containing any 4xx error (except 404 on DELETE). Default is false.
array
required
List of batch operations to execute. Maximum 1000 operations per request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_CALENDAR_LIST_DELETERemoves a calendar from the user’s calendar list, unsubscribing from it without deleting the calendar itself.

Input Parameters

string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the ‘primary’ keyword.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_CALENDAR_LIST_GETRetrieves metadata for a SINGLE specific calendar from the user’s calendar list by its calendar ID. This action requires a calendarId parameter and returns details about that one calendar only. NOTE: This does NOT list all calendars. To list all calendars in the user’s calendar list, use GOOGLECALENDAR_CALENDAR_LIST_LIST instead.

Input Parameters

string
required
Required. The calendar identifier for the single calendar to retrieve. Use ‘primary’ for the primary calendar of the authenticated user, or provide a specific calendar ID (e.g., an email address or group calendar ID). To find calendar IDs, first use GOOGLECALENDAR_CALENDAR_LIST_LIST to list all calendars.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_CALENDAR_LIST_INSERTInserts an existing calendar into the user’s calendar list, with optional display settings. The primary keyword is not accepted; provide the actual calendar ID.

Input Parameters

string
required
The identifier of the calendar to insert. Must be a valid calendar ID in email format (e.g., ‘user@example.com’ for a user’s calendar or ‘calendarid@group.calendar.google.com’ for a shared calendar). Note: The ‘primary’ keyword is not supported for this operation - use the actual email address of the primary calendar instead. The calendar must exist and you must have appropriate access permissions.
boolean
Whether the calendar has been hidden from the list. Accepts only boolean values: true or false. If not specified, the API defaults to false.
string
The color of the calendar. This is an ID referring to an entry in the calendarCore color palette.
boolean
Whether the calendar is selected and visible in the calendar list. Accepts only boolean values: true or false. If not specified, the API defaults to false.
string
The background color of the calendar in the Web UI. (Hexadecimal color code)
string
The foreground color of the calendar in the Web UI. (Hexadecimal color code)
string
The summary that the authenticated user has set for this calendar.
boolean
Whether to use the foregroundColor and backgroundColor fields to write the calendar colors (RGB). If this feature is used, the index-based colorId field will be set to the best matching option automatically. Optional. The default is False.
array
The default reminders that the authenticated user has for this calendar.
object
The notifications that the authenticated user is receiving for this calendar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_CALENDAR_LIST_PATCHUpdates an existing calendar on the user’s calendar list using patch semantics. This method allows partial updates, modifying only the specified fields.

Input Parameters

boolean
Whether calendar is hidden.
string
ID for calendar color from colors endpoint.
boolean
Whether calendar content shows in UI.
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. Use “primary” keyword for the currently logged in user’s primary calendar.
boolean
Whether to use RGB for foreground/background colors.
string
Hex color for calendar background.
string
Hex color for calendar foreground.
string
User-set summary for the calendar.
array
List of default reminders.
object
Notification settings for the calendar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_CALENDAR_LIST_UPDATEUpdates a calendar list entry’s display/subscription settings (color, visibility, reminders, selection) for the authenticated user — does not modify the underlying calendar resource (title, timezone, etc.). To modify the calendar itself, use GOOGLECALENDAR_CALENDARS_UPDATE.

Input Parameters

boolean
Whether calendar is hidden.
string
ID for calendar color from colors endpoint.
boolean
Whether calendar content shows in UI.
string
required
Calendar identifier. Must be an actual calendar ID (e.g., “examplecalendar@group.calendar.google.com” or “c_abc123…@group.calendar.google.com”). To retrieve valid calendar IDs, use the GOOGLECALENDAR_LIST_CALENDARS action first. The “primary” alias is not valid for calendarList.update.
boolean
Whether to use RGB for foreground/background colors.
string
Hex color for calendar background.
string
Hex color for calendar foreground.
string
User-set summary for the calendar.
array
List of default reminders.
object
Notification settings for the calendar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_CALENDAR_LIST_WATCHCreates a push-notification channel for changes to the user’s calendar list. Notifications signal changes rather than providing full change details, and delivery is not completely reliable.

Input Parameters

string
required
A UUID or similar unique string that identifies this channel. Maximum 64 characters.
string
required
The type of delivery mechanism used for this channel. Must be “web_hook” or “webhook”.
string
An arbitrary string delivered to the target address with each notification. Maximum 256 characters. Used for channel verification and message routing.
object
Additional parameters controlling delivery channel behavior.
string
required
The HTTPS URL where notifications are delivered for this channel. Must have a valid SSL certificate.
integer
Unix timestamp in milliseconds indicating when the API should stop sending notifications.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_CALENDARS_DELETEDeletes a secondary calendar that you own or have delete permissions on. Deletion is permanent and irreversible — verify the correct calendar_id before calling. You cannot delete your primary calendar or calendars you only have read/write access to. Use calendarList.list to find calendars with owner accessRole. For primary calendars, use calendars.clear instead. Parallel calls may trigger userRateLimitExceeded; sequence bulk deletions.

Input Parameters

string
required
Calendar identifier for a secondary calendar you own or have delete permissions on. Use calendarList.list to find deletable calendar IDs (look for accessRole “owner”). Primary calendars cannot be deleted; use the Clear Calendar action instead.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_CALENDARS_UPDATEFull PUT-style update that overwrites all calendar metadata fields; unspecified optional fields are cleared. Use GOOGLECALENDAR_PATCH_CALENDAR to update only a subset of fields. Mutates the underlying calendar resource (title, description, timeZone, etc.); use GOOGLECALENDAR_CALENDAR_LIST_UPDATE to change per-user display properties like color.

Input Parameters

string
required
Title of the calendar. Must be a non-empty string; passing an empty string clears the calendar title.
string
Geographic location of the calendar as free-form text. Optional.
string
The time zone of the calendar. (Formatted as an IANA Time Zone Database name, e.g. “Europe/Zurich”.) Optional.
string
required
Calendar identifier. Use ‘primary’ to update the primary calendar of the currently logged in user, or provide a specific calendar ID (typically in email format like ‘abc123@group.calendar.google.com’). To retrieve calendar IDs call the calendarList.list method. IMPORTANT: This is NOT the calendar’s display name/title. NOTE: For better performance, prefer providing the actual calendar ID instead of ‘primary’, as the ‘primary’ alias requires an additional API call to resolve.
string
Description of the calendar. Optional.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_CHANNELS_STOPTool to stop watching resources through a notification channel. Use when you need to discontinue push notifications for a specific channel subscription.

Input Parameters

string
required
A UUID or similar unique string that identifies this channel.
string
An arbitrary string delivered to the target address with each notification delivered over this channel. Optional.
string
required
An opaque ID that identifies the resource being watched on this channel. Stable across different API versions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_CLEAR_CALENDARClears a primary calendar by deleting all events from it. The calendar itself is preserved; only its events are removed. Primary calendars cannot be deleted entirely.

Input Parameters

string
required
Primary calendar to clear: “primary” or the account’s own email address. Google only clears primary calendars; secondary calendar IDs return 400 Invalid Value. To remove a secondary calendar’s events, delete them individually or delete the calendar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_COLORS_GETReturns the color definitions for calendars and events. Use when you need to retrieve the available color palette for styling calendars or events.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_CREATE_CALENDARCreates a new secondary Google Calendar with the specified title and optional settings. Use this action when you need to create a new calendar for organizing events separately from the primary calendar. The authenticated user becomes the owner of the newly created calendar. Optional parameters include description, location, and timezone.

Input Parameters

string
required
Title of the calendar. This is the name that will be displayed in Google Calendar.
string
Geographic location of the calendar as free-form text.
string
The time zone of the calendar, specified as an IANA Time Zone Database name (e.g., ‘America/New_York’, ‘Europe/London’, ‘Asia/Tokyo’). If not specified, defaults to UTC.
string
Description of the calendar. Provides additional context about the calendar’s purpose.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_CREATE_EVENTCreates a timed or all-day Google Calendar event and returns it under response_data, without conflict checking. send_updates defaults to “all”, which emails all attendees; for eligible event types, the organizer is added unless excluded and a Google Meet link is requested by default.

Input Parameters

string
Summary (title) of the event.
string
Exclusive end date for an all-day event in YYYY-MM-DD format. Must be provided together with start_date and be later than start_date.
string
Geographic location of the event as free-form text.
string
IANA timezone name from the timezone database (e.g., ‘America/New_York’, ‘Europe/London’, ‘Asia/Jerusalem’, ‘UTC’). Required if datetime is naive. For recurring events, start and end must include a timeZone. If not provided, UTC is used. If datetime includes timezone info (Z or offset), this field is optional and defaults to UTC. IMPORTANT: Must be a valid IANA timezone identifier. Values like ‘EST’, ‘PST’, ‘ISRAEL TIME’, or other abbreviations are NOT valid IANA timezone names.
array
List of attendees. Each attendee can be either: (1) A string email address (e.g., ‘user@example.com’), or (2) An object with ‘email’ (required), ‘optional’ (boolean, default false), ‘displayName’ (string), ‘comment’ (string), ‘additionalGuests’ (integer), and ‘resource’ (boolean). To mark an attendee as optional (not required), use object format: {‘email’: ‘user@example.com’, ‘optional’: true}. IMPORTANT: Only valid email addresses are accepted. Plain names cannot be used.
string ("birthday" | "default" | "focusTime" | "outOfOffice" | "workingLocation")
Type of the event, immutable post-creation. ‘workingLocation’ (REQUIRES Google Workspace Enterprise). Note: ‘fromGmail’ events cannot be created via API.
array
List of RRULE, EXRULE, RDATE, EXDATE lines for recurring events. Supported frequencies: DAILY, WEEKLY, MONTHLY, YEARLY. For recurring events, start.timeZone and end.timeZone must be present. UNTIL values follow RFC 5545: date-only (YYYYMMDD) for all-day events, or UTC datetime with Z suffix (YYYYMMDDTHHMMSSZ) for timed events. UNTIL values with time but missing Z suffix are auto-corrected. Provide an empty list to remove recurrence so the event becomes non-recurring.
string
Inclusive start date for an all-day event in YYYY-MM-DD format. Must be provided together with end_date and without start_datetime or end_datetime.
string ("default" | "public" | "private" | "confidential")
Event visibility: ‘default’, ‘public’, ‘private’, or ‘confidential’.
string
Calendar identifier. Use ‘primary’ (recommended) for the user’s main calendar. Alternatively, use a calendar ID from the user’s accessible calendar list. Calendar IDs look like email addresses (e.g., ‘xyz@group.calendar.google.com’ for shared calendars). Important: Arbitrary email addresses will NOT work - the calendar must exist in the user’s calendar list with appropriate access permissions. Use GOOGLECALENDAR_LIST_CALENDARS to retrieve valid calendar IDs.
string
Description of the event. Can contain HTML. Optional. Must be omitted for ‘birthday’ event type.
string
Event end time in ISO 8601 format: YYYY-MM-DDTHH:MM:SS. When provided, this parameter takes precedence over event_duration_hour and event_duration_minutes. If not provided, the end time is calculated using start_datetime + duration. Must be after start_datetime. Explicit timezone information (Z or an offset) is preserved; offset-less values are interpreted in timezone, or UTC when it is omitted.
string ("all" | "externalOnly" | "none")
Options for who should receive notifications about event changes.
string ("opaque" | "transparent")
‘opaque’ (busy) or ‘transparent’ (available).
string
Event start time in ISO 8601 format: YYYY-MM-DDTHH:MM:SS. Required for timed events; omit it when using start_date and end_date for an all-day event.
boolean
If True, guests can modify the event.
boolean
If True, the organizer will NOT be added as an attendee. Default is False (organizer is included).
object
Properties for birthday events.
boolean
Defaults to True. When True, for CREATE operations creates a Google Meet link; for UPDATE operations preserves existing conference data if present, or adds a new Meet link if none exists. Google Workspace accounts will successfully receive a Meet link. Personal Gmail accounts and other unsupported accounts will gracefully fallback to creating an event without a Meet link when conference creation fails. Set to False to skip Meet link operations (won’t create new or modify existing conference data). The fallback ensures event creation succeeds even when conference features are unavailable due to account limitations.
integer
Number of hours for the event duration. Supports multi-day events (e.g., 240 hours = 10 days). For durations under 1 hour, use event_duration_minutes instead. Ignored if end_datetime is provided.
object
Extended properties of the event for storing custom metadata. Contains ‘private’ (visible only on this calendar) and/or ‘shared’ (visible to all attendees) dictionaries mapping string keys to string values. Example: {‘private’: {‘key1’: ‘value1’}, ‘shared’: {‘key2’: ‘value2’}}
object
Properties for focusTime events. REQUIRES Google Workspace Enterprise account with Focus Time feature enabled.
boolean
Whether attendees other than the organizer can invite others to the event.
object
Properties for outOfOffice events.
integer
Duration in minutes (0-59 ONLY). NEVER use 60+ minutes - use event_duration_hour=1 instead. Maximum value is 59. Combined duration (hours + minutes) must be greater than 0. Ignored if end_datetime is provided.
boolean
Whether attendees other than the organizer can see who the event’s attendees are.
object
Properties for workingLocation events. REQUIRES Google Workspace Enterprise. Constraints discovered from testing: - Must set transparency=‘transparent’ and visibility=‘public’ - Description must be omitted - Depending on ‘type’, include one of ‘homeOffice’, ‘officeLocation’, or ‘customLocation’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_DELETE_EVENTDeletes an event from the specified calendar. Only Google’s HTTP 204 confirms deletion; 404 or 410 can also mean the event belongs to a different calendar. Bulk deletions may trigger rateLimitExceeded or userRateLimitExceeded; cap concurrency to 5–10 requests and apply exponential backoff.

Input Parameters

string
required
Unique identifier of the event to delete. For standalone events, use the base event ID (e.g., ‘abc123def456’). For recurring event instances, use the instance ID format ‘baseEventId_YYYYMMDDTHHMMSSZ’ (e.g., ‘abc123def456_20260522T093000Z’) where the timestamp suffix represents the instance’s original start time in UTC. Instance IDs can be obtained from the EVENTS_INSTANCES action. To delete ALL occurrences of a recurring event, use the base event ID without the timestamp suffix. Must be the internal API identifier from a prior API response — UI-visible identifiers, URL-encoded variants, or shortened IDs are invalid and cause 404/validation errors.
string
Identifier of the Google Calendar (e.g., email address, specific ID, or ‘primary’ for the authenticated user’s main calendar) from which the event will be deleted. Calendars without event-deletion permission, including subscribed calendars not owned by the authenticated user, return 403 on deletion attempts.
string ("all" | "externalOnly" | "none")
Options for who should receive notifications about event changes.
boolean
Deprecated. Whether to send notifications about the deletion of the event. Note that some emails might still be sent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_DUPLICATE_CALENDARCreates a new, empty Google Calendar with the specified title (summary). Newly created calendars default to UTC timezone; use GOOGLECALENDAR_PATCH_CALENDAR afterward to set the desired timeZone if needed.

Input Parameters

string
required
Title for the new Google Calendar to be created. Required and must be a non-empty string.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_EVENTS_GETRetrieves a SINGLE event by its unique event_id (REQUIRED). This action does NOT list or search events - it fetches ONE specific event when you already know its ID. If you want to list events within a time range, search for events, or filter by criteria like time_min/time_max, use GOOGLECALENDAR_EVENTS_LIST instead.

Input Parameters

string
required
REQUIRED. The unique identifier of the specific event to retrieve. You must already know this ID (e.g., from a previous EVENTS_LIST call or event creation response). This action fetches ONE event by ID - it cannot list or search events. To find events by time range or search criteria, use GOOGLECALENDAR_EVENTS_LIST instead.
string
Time zone used in the response. If not specified, the calendar’s time zone is used.
string
Identifier of the Google Calendar (e.g., email address, specific ID, or ‘primary’ for the authenticated user’s main calendar) from which to retrieve the event.
integer
Maximum number of attendees to include in the response. If there are more than the specified number, only the participant is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_EVENTS_IMPORTTool to import an event as a private copy to a calendar. Use when you need to add an existing event to a calendar using its iCalUID. Only events with eventType=‘default’ can be imported.

Input Parameters

object
required
The (exclusive) end time of the event. For all-day events, use ‘date’ field; for timed events, use ‘dateTime’ and ‘timeZone’ fields.
object
required
The (inclusive) start time of the event. For all-day events, use ‘date’ field; for timed events, use ‘dateTime’ and ‘timeZone’ fields. dateTime must be ISO 8601 format (e.g., '2024-01-15T10:00:00'); timeZone should match the calendar’s timezone to avoid shifted times.
object
Source from which the event was created.
string
Status of the event. Possible values: ‘confirmed’, ‘tentative’, ‘cancelled’.
string
The color of the event. This is an ID referring to an entry in the event colors definition.
string
required
Event unique identifier as defined in RFC5545. This is required to identify the event being imported.
string
Title of the event.
string
Geographic location of the event as free-form text.
integer
Sequence number as per iCalendar.
array
The attendees of the event.
object
Information about the event’s reminders for the authenticated user.
array
List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event, as specified in RFC5545. Each string must include the full prefix (e.g., 'RRULE:FREQ=WEEKLY;BYDAY=MO'); omitting the prefix causes a 400 error.
string
Visibility of the event. Possible values: ‘default’, ‘public’, ‘private’, ‘confidential’. Default: ‘default’.
array
File attachments for the event.
string
Calendar identifier. Use ‘primary’ for the logged-in user’s primary calendar or the calendar’s email address.
string
Description of the event. Can contain HTML.
string
Whether the event blocks time on the calendar. Possible values: ‘opaque’ (blocks time), ‘transparent’ (does not block time). Default: ‘opaque’.
boolean
Whether attendees other than the organizer can modify the event. Default: False.
object
Extended properties of the event.
boolean
Whether API client performing operation supports event attachments. Default: False.
integer
Version number of conference data supported by the API client. Version 0 assumes no conference data support and ignores conference data in the event’s body. Version 1 enables copying of ConferenceData as well as for creating new conferences using the createRequest field of conferenceData. Default: 0.
boolean
Whether attendees other than the organizer can invite others to the event. Default: True.
boolean
Whether attendees other than the organizer can see who the event’s attendees are. Default: True.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_EVENTS_INSTANCESReturns instances of the specified recurring event. Use timeMin/timeMax to constrain the window; omitting bounds can return large result sets and is quota-heavy. On high-volume calls, 403 rateLimitExceeded or 429 too_many_requests may occur; apply exponential backoff (1s, 2s, 4s) before retrying.

Input Parameters

string
required
REQUIRED. The ID of the recurring event whose instances you want to retrieve. You must first use GOOGLECALENDAR_FIND_EVENT or GOOGLECALENDAR_EVENTS_LIST to find recurring events and get their IDs. This action only works with recurring events that have a recurrence rule.
string
Upper bound (exclusive) for an event’s start time to filter by. Optional. The default is not to filter by start time. Must be an RFC3339 timestamp with mandatory time zone offset.
string
Lower bound (inclusive) for an event’s end time to filter by. Optional. The default is not to filter by end time. Must be an RFC3339 timestamp with mandatory time zone offset.
string
Time zone used in the response. Optional. The default is the time zone of the calendar.
string
Token specifying which result page to return. Optional.
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.
integer
Maximum number of events returned on one result page. By default the value is 250 events. The page size can never be larger than 2500 events. Optional.
boolean
Whether to include deleted events (with status equals “cancelled”) in the result. Cancelled instances of recurring events will still be included if singleEvents is False. Optional. The default is False.
integer
The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional.
string
The original start time of the instance in the result. Optional.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_EVENTS_LISTLists or incrementally synchronizes events from one calendar, defaulting to the connected user’s primary calendar. Use timeMin/timeMax for a time window, singleEvents to expand recurring series, showDeleted to include cancelled events, query for text search, orderBy to sort, pageToken to continue a page sequence, and syncToken to retrieve changes after a completed full sync. A sync token cannot be combined with event, text, property, time, update-time, or ordering filters; keep other parameters unchanged across sync pages. The final page returns nextSyncToken, and an expired token requires a new full sync after Google returns HTTP 410. Use fields to request a smaller partial response, including continuation tokens needed by the workflow.

Input Parameters

string
Free text search terms to find events that match these terms in various fields. Optional.
string
Google partial-response selector that limits which fields are returned. Use comma-separated fields and nested selectors, for example ‘items(id,status,summary,start,end,updated),nextPageToken,nextSyncToken’. Include nextPageToken when paginating and nextSyncToken when synchronizing, and keep the same selector on every page and incremental-sync request.
string
Specifies an event ID in the iCalendar format to be provided in the response. Optional. Use this if you want to search for an event by its iCalendar ID.
string ("startTime" | "updated")
The order of the events returned in the result. Optional. The default is an unspecified, stable order. Acceptable values are: “startTime”, “updated”. When set to “startTime”, singleEvents must be true. The action automatically sets singleEvents=true when orderBy=‘startTime’.
string
Upper bound (exclusive) for an event’s start time to filter by. Optional. If unset, no start-time upper bound is applied. Must be an RFC3339 timestamp with mandatory time zone offset (e.g., 2011-06-03T10:00:00-07:00 or 2011-06-03T10:00:00Z). Milliseconds may be provided but are ignored. If timeMin is set, timeMax must be greater than timeMin. TIMEZONE WARNING: If using UTC times (ending in ‘Z’) but the calendar is in a different timezone, the time window may not align with local calendar dates. For example, ‘2026-01-19T00:00:00Z’ to ‘2026-01-20T00:00:00Z’ covers 2026-01-18 4pm to 2026-01-19 4pm in America/Los_Angeles (UTC-8). To query a specific local date, use timestamps with the appropriate local timezone offset (e.g., ‘2026-01-19T00:00:00-08:00’ for PST). NOTE: Natural language expressions like ‘today’, ‘tomorrow’, ‘next week’ are NOT supported.
string
Lower bound (exclusive) for an event’s end time to filter by. Optional. If unset, no end-time lower bound is applied. Must be an RFC3339 timestamp with mandatory time zone offset (e.g., 2011-06-03T10:00:00-07:00 or 2011-06-03T10:00:00Z). Milliseconds may be provided but are ignored. If timeMax is set, timeMin must be smaller than timeMax. TIMEZONE WARNING: If using UTC times (ending in ‘Z’) but the calendar is in a different timezone, the time window may not align with local calendar dates. For example, ‘2026-01-19T00:00:00Z’ to ‘2026-01-20T00:00:00Z’ covers 2026-01-18 4pm to 2026-01-19 4pm in America/Los_Angeles (UTC-8). To query a specific local date, use timestamps with the appropriate local timezone offset (e.g., ‘2026-01-19T00:00:00-08:00’ for PST). NOTE: Natural language expressions like ‘today’, ‘tomorrow’, ‘next week’ are NOT supported.
string
Time zone used in the response for formatting event times. Optional. Use an IANA time zone identifier (e.g., America/Los_Angeles). Defaults to the user’s primary time zone. Offsets (e.g., ‘-03:00’, ‘UTC+0’) and abbreviations (e.g., ‘IST’, ‘PST’) are invalid. NOTE: This parameter only affects how event times are displayed in the response. It does NOT change how timeMin/timeMax filtering is interpreted. To query a specific local date, use timestamps with the appropriate timezone offset directly in timeMin/timeMax (e.g., ‘2026-01-19T00:00:00-08:00’).
string
Opaque pagination token from a previous response’s nextPageToken field. Must be the exact string returned by the API - do not use placeholder values like ‘NEXT’, ‘next’, ‘1’, ‘2’, etc. Omit this parameter for the first page. Keep the calendar, filters, fields selector, and syncToken unchanged while paging. Continue until nextPageToken is absent; nextSyncToken is returned only on the final page.
string
Token from nextSyncToken to return only entries changed since the last list. Cannot be combined with iCalUID, orderBy, privateExtendedProperty, q, sharedExtendedProperty, timeMin, timeMax, or updatedMin. Deletions since the previous list are always included; showDeleted cannot be false in this mode. Keep all other parameters identical to the initial full sync and retain this token while following pageToken values. The action automatically removes conflicting parameters when syncToken is provided. If Google returns HTTP 410, discard the token and perform a new full sync without syncToken.
string
Calendar identifier. Use “primary” for the user’s main calendar, or a calendar ID from the user’s accessible calendar list. Arbitrary email addresses will NOT work - the calendar must exist in the user’s calendar list. Use GOOGLECALENDAR_LIST_CALENDARS to retrieve valid calendar IDs. Defaults to “primary”. Empty strings will be treated as “primary”. Do NOT use Composio internal IDs like connectedAccountId (which start with “ca_”) - these will be automatically replaced with “primary”.
array
Event types to return. Google accepts this query parameter more than once, so provide a list to include multiple types. A single string is also accepted for compatibility. If unset, returns all event types. Values: “birthday”, “default”, “focusTime”, “fromGmail”, “outOfOffice”, “workingLocation”.
integer
Maximum number of events returned on one result page. The number of events in the resulting page may be less than this value, or none at all, even if there are more events matching the query. Incomplete pages can be detected by a non-empty nextPageToken field in the response. By default the value is 250 events. The page size can never be larger than 2500 events. Optional. Must be >= 1 if provided.
string
Lower bound for an event’s last modification time (RFC3339). When specified, entries deleted since this time are always included regardless of showDeleted. Optional.
boolean
Include cancelled events (status=“cancelled”). Optional; default is false. This surfaces cancelled (soft-deleted) events, not items in the Trash. When syncToken or updatedMin is used, deletions since those markers are included regardless of showDeleted. Recurring interaction: if singleEvents=false and showDeleted=false, cancelled instances of a recurring series may still be included; if showDeleted=true and singleEvents=true, only single deleted instances (not parent series) are returned.
integer
The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional. Must be >= 1 if provided.
boolean
Whether to expand recurring events into instances and only return single one-off events and instances of recurring events. Optional. The default is False.
boolean
Deprecated and ignored.
boolean
Whether to include hidden invitations in the result. Optional. The default is False. Hidden invitations are events where your attendee entry has responseStatus=‘needsAction’ and attendees[].self==true. When true, such invitations are included.
string
Extended properties constraint specified as propertyName=value. Matches only shared properties. This parameter might be repeated multiple times to return events that match all given constraints.
string
Extended properties constraint specified as propertyName=value. Matches only private properties. This parameter might be repeated multiple times to return events that match all given constraints.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_EVENTS_LIST_ALL_CALENDARSLists and deduplicates events across selected calendars or the user’s calendar list for a time range. Returns a compact summary by default, with full event details available on request; per-calendar errors can make results incomplete.

Input Parameters

string
Free text search terms to find events that match these terms in any field, except for extended properties. Optional.
string
required
Upper bound (exclusive) for an event’s start time to filter by. Must be an RFC3339 timestamp with mandatory time zone offset (e.g., 2011-06-03T10:00:00-07:00 or 2011-06-03T10:00:00Z). If timezone offset is missing, UTC (Z) will be automatically appended. Required.
string
required
Lower bound (inclusive) for an event’s end time to filter by. Must be an RFC3339 timestamp with mandatory time zone offset (e.g., 2011-06-03T10:00:00-07:00 or 2011-06-03T10:00:00Z). If timezone offset is missing, UTC (Z) will be automatically appended. Required.
array
Event types to return. Optional.
array
Optional list of specific calendar IDs to query. If not provided, all calendars from the user’s calendar list will be queried.
boolean
Whether to include deleted events (with status equals ‘cancelled’) in the result. Optional. The default is False.
boolean
Whether to expand recurring events into instances and only return single one-off events and instances of recurring events. Optional. The default is True.
string ("minimal" | "full")
Level of detail in the response. ‘minimal’ (default) returns only the compact summary_view, omitting the large events array to reduce token usage. ‘full’ returns both summary_view and the full detailed events array.
integer
Maximum number of events returned per calendar. Optional. If not provided, defaults to the API’s default (250). Results may be paginated; follow nextPageToken in the response until absent to retrieve the complete event list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_EVENTS_MOVEMoves a default event to another calendar, changing its organizer. Other event types cannot be moved.

Input Parameters

string
required
Event identifier. To retrieve event identifiers call the events.list method.
string
required
Calendar identifier of the source calendar. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.
string
required
Calendar identifier of the destination calendar. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.
string ("all" | "externalOnly" | "none")
Options for who should receive notifications about event changes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_EVENTS_WATCHWatch for changes to Events resources. Watch channels expire; persist the channel id per calendarId to re-establish watches after expiration or restarts.

Input Parameters

string
required
A UUID or similar unique string that identifies this channel.
string
The type of delivery mechanism used for this channel.
string
An arbitrary string delivered to the target address with each notification delivered over this channel. Optional.
object
Additional parameters controlling delivery channel behavior. Optional.
string
required
The address where notifications are delivered for this channel. Must be a publicly accessible HTTPS URL; http:// or localhost URLs will not receive notifications.
boolean
A Boolean value to indicate whether payload is wanted. Optional.
string
required
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_FIND_EVENTFinds events in a specified Google Calendar using text, time ranges, and event types. Results are returned in event_data.event_data and may span multiple pages; follow nextPageToken even when a page is empty.

Input Parameters

string
Free-text search terms to find events. This query is matched against various event fields including summary, description, location, attendees’ details (displayName, email), and organizer’s details. Cannot search by event_id. Performs full-text match (not exact); broad terms may return unrelated events. For person-based matching, prefer attendees[].email over display names. If results appear incomplete, use GOOGLECALENDAR_EVENTS_LIST with client-side filtering.
string
Order of events: ‘startTime’ (ascending by start time) or ‘updated’ (ascending by last modification time). Note: ‘startTime’ requires single_events=true. Use ‘updated’ if you need to include recurring masters (e.g., cancelled series).
string
Upper bound (exclusive) for an event’s start time to filter by. Only events starting before this time are included. Accepts multiple formats: 1. RFC3339 timestamp (e.g., ‘2024-12-06T13:00:00Z’) 2. Comma-separated date/time parts (e.g., ‘2024,12,06,13,00,00’) 3. Simple datetime string (e.g., ‘2024-12-06 13:00:00’) Set to the first instant after the desired period to avoid missing boundary events, especially all-day events (date-only fields). Overly wide ranges expand many recurring instances, causing large payloads and high latency — constrain to the minimum required window.
string
Lower bound (exclusive) for an event’s end time to filter by. Only events ending after this time are included. Accepts multiple formats: 1. RFC3339 timestamp (e.g., ‘2024-12-06T13:00:00Z’) 2. Comma-separated date/time parts (e.g., ‘2024,12,06,13,00,00’) 3. Simple datetime string (e.g., ‘2024-12-06 13:00:00’) RFC3339 timestamps must include explicit timezone offsets; missing or mismatched offsets can silently exclude matching events. To align with the calendar’s timezone, retrieve it via GOOGLECALENDAR_GET_CALENDAR.
string
Token from a previous response’s nextPageToken to fetch the subsequent page of results. Always follow every nextPageToken until absent; skipping pagination silently omits events on busy calendars.
string
Identifier of the Google Calendar to query. IMPORTANT: This must be a valid calendar identifier, NOT a calendar name/title. Valid formats are: ‘primary’ (the authenticated user’s primary calendar), an email address (e.g., ‘user@example.com’), or a calendar ID (e.g., ‘abc123xyz@group.calendar.google.com’). To find the calendar ID for a named calendar, first use the List Calendars action (GOOGLECALENDAR_LIST_CALENDARS) to retrieve all available calendars with their IDs. ‘primary’ searches only the authenticated user’s primary calendar; to search all calendars, retrieve each ID via GOOGLECALENDAR_LIST_CALENDARS and query separately.
array
Event types to include. Supported values: ‘birthday’, ‘default’, ‘focusTime’, ‘outOfOffice’, ‘workingLocation’.
integer
Maximum number of events per page (1-2500).
string
Lower bound (exclusive) for an event’s last modification time to filter by. Only events updated after this time are included. When specified, events deleted since this time are also included, regardless of the show_deleted parameter. Accepts multiple formats: 1. RFC3339 timestamp (e.g., ‘2024-12-06T13:00:00Z’) 2. Comma-separated date/time parts (e.g., ‘2024,12,06,13,00,00’) 3. Simple datetime string (e.g., ‘2024-12-06 13:00:00’)
boolean
Include events whose status is ‘cancelled’. This surfaces cancelled/deleted events, not a separate ‘trash’ view. Behavior with recurring events: when single_events=true, only individual cancelled instances are returned (the recurring master is omitted); to include cancelled recurring masters, set single_events=false. If updated_min is provided, events deleted since that time are included regardless of this flag.
boolean
When true, recurring event series are expanded into their individual instances. When false, only the recurring master events are returned. Note: Ordering by ‘startTime’ requires singleEvents=true. For large calendars, it is strongly recommended to specify both timeMin and timeMax to limit the expansion window and improve performance.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_FIND_FREE_SLOTSQueries busy intervals and calculates free gaps for specified calendars, without filtering by meeting duration; the range is limited to 89 days, and calendar errors produce empty free slots marked unreliable. Omitted start defaults to now, and omitted end to 23:59:59 on the applicable day in the specified timezone.

Input Parameters

array
List of calendar identifiers to query for free/busy information. Pass as a simple list of strings, e.g., [‘primary’] or [‘primary’, ‘user@example.com’]. Valid values include: ‘primary’ (authenticated user’s main calendar), calendar IDs from the user’s calendar list (typically ending in @group.calendar.google.com), or email addresses of users whose free/busy information you want to query. The FreeBusy API will return error information for any calendars that are not accessible or invalid in the response under the ‘errors’ key for each calendar. Calendars omitted from items or inaccessible are treated as free (not unknown), which can silently produce incorrect availability results.
string
End datetime for the query interval. Accepts ISO, comma-separated, or simple datetime formats. If provided without an explicit timezone, it is interpreted in the specified timezone. If not provided, defaults to 23:59:59 of the day specified in time_min (if provided), otherwise defaults to 23:59:59 of the current day in the specified timezone. Maximum span between time_min and time_max is approximately 90 days per Google Calendar freeBusy API limit. time_max is exclusive; to cover a full day, set time_max to 00:00:00 of the following day in the target timezone rather than 23:59:59.
string
Start datetime for the query interval. Accepts ISO, comma-separated, or simple datetime formats. If provided without an explicit timezone, it is interpreted in the specified timezone. If not provided, defaults to the current timestamp in the specified timezone to ensure only future/bookable slots are returned. Maximum span between time_min and time_max is approximately 90 days per Google Calendar freeBusy API limit.
string
IANA timezone identifier (e.g., ‘America/New_York’, ‘Europe/London’, ‘Asia/Tokyo’). Determines how naive time_min/time_max are interpreted and the timezone used in the response for timeMin, timeMax, busy periods, and calculated free slots. Note: ‘local’ is not supported; use a specific IANA timezone name.
integer
Maximum calendar identifiers to return for a single group. Must be between 1 and 100 (inclusive). Values exceeding 100 will be rejected.
integer
Maximum calendars for which FreeBusy information is provided. Must be between 1 and 50 (inclusive). Values exceeding 50 will be rejected.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_FREE_BUSY_QUERYQueries raw busy intervals for one or more calendars or groups over an exact time range. Returns per-calendar and per-group availability and errors, without event titles or details. Use GOOGLECALENDAR_FIND_FREE_SLOTS when you want default time bounds and computed free intervals; use GOOGLECALENDAR_EVENTS_LIST when you need event records.

Input Parameters

array
required
List of calendars and/or groups to query. Accepts either strings (e.g., [‘primary’, ‘user@example.com’]) or objects with an ‘id’ field (e.g., [{‘id’: ‘primary’}]). String values are automatically converted to the proper format. Only calendars with at least freeBusyReader-level access are queried; omitting shared/secondary calendars can hide real conflicts. Batch all attendees into one call to avoid 403 rateLimitExceeded or 429 tooManyRequests errors.
string
required
The end of the interval for the query formatted as per RFC3339. Exclusive bound; must be greater than timeMin. Keep the timeMin–timeMax window within ~90 days; larger spans may return empty or degraded results.
string
required
The start of the interval for the query formatted as per RFC3339. Must be strictly less than timeMax. For full-day windows, use local 00:00 in the target timezone to avoid DST/off-by-one errors.
string
Time zone used in the response. Optional. The default is UTC. Defaults to UTC, which skews working-hours analysis for users in other timezones; always supply a valid IANA timezone (e.g., ‘America/New_York’).
integer
Maximal number of calendar identifiers to be provided for a single group. Optional. An error is returned for a group with more members than this value. Maximum value is 100.
integer
Maximal number of calendars for which FreeBusy information is to be provided. Optional. Maximum value is 50.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_GET_CALENDARGets canonical metadata for one Google Calendar, defaulting to the authenticated user’s primary calendar. Returns its identifier, title, description, location, time zone, and conference properties. Use GOOGLECALENDAR_CALENDAR_LIST_GET for one calendar’s user-specific list settings such as access role, color, visibility, selection, and default reminders; use GOOGLECALENDAR_LIST_CALENDARS to enumerate accessible calendars.

Input Parameters

string
Identifier of the Google Calendar to retrieve. Must be ‘primary’ (the default) for the user’s main calendar, or an email-like identifier (e.g., ‘user@example.com’ or ‘en.usa#holiday@group.v.calendar.google.com’). IMPORTANT: Calendar display names/titles (e.g., ‘Work’, ‘Vacation’) are NOT valid identifiers and will result in errors. To find a calendar’s ID, use the LIST_CALENDARS action which returns the ‘id’ field for each calendar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_GET_CALENDAR_PROFILEDEPRECATED: Use CalendarListGet instead. Tool to retrieve the authenticated user’s primary calendar profile. Use when you need to get information about the user’s main calendar, including timezone, settings, and preferences.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_GET_CURRENT_DATE_TIMEGets the current date and time, allowing for a specific timezone offset. Call this tool first before computing relative dates (e.g., ‘tomorrow’, ‘next Monday’) to avoid off-by-one-day errors across timezones.

Input Parameters

string
Timezone specification. Accepts: (1) IANA timezone identifier (e.g., ‘America/New_York’, ‘Asia/Kolkata’, ‘Europe/London’) - RECOMMENDED, (2) Common timezone abbreviations (e.g., ‘PST’, ‘EST’, ‘CST’, ‘GMT’, ‘UTC’) - will be auto-converted to IANA, or (3) Numeric UTC offset in hours (e.g., -5, 5.5). Use positive values for east of UTC, negative for west. Default 0 is UTC.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_GET_CURRENT_USERIdentifies the Google user connected to Calendar from the primary calendar resource. Returns the account identifier, email when available, display name, timezone, and primary calendar ID. This is Calendar identity metadata, not a full Google Account or People profile.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_LIST_BUILDINGSLists a page of buildings for a Google Workspace customer, including available addresses, coordinates, and floor names. Use the continuation token for further pages; Directory API access and appropriate administrator privileges are required.

Input Parameters

string
The unique ID for the customer’s Google Workspace account. Use ‘my_customer’ alias to represent your account’s customer ID. As an account administrator, this alias represents your account’s customer ID.
string
Token to specify the next page in the list. Obtained from nextPageToken in a previous response. Omit for the first page.
integer
Maximum number of buildings to return per page. Defaults to 25 for optimal performance.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_LIST_CALENDAR_RESOURCESRetrieves calendar resources (such as conference rooms) from a Google Workspace domain using the Admin SDK Directory API. Use this action when you need to list available meeting rooms, conference spaces, or other bookable calendar resources in an organization. The action supports filtering by resource category, capacity, building location, and other criteria. IMPORTANT: This requires Admin SDK Directory API access and appropriate admin permissions - it is NOT available for personal Gmail accounts, only Google Workspace domains.

Input Parameters

string
Search query to filter calendar resources. Each clause is ‘field operator value’. Supported operators: ’=’ (exact match), ’!=’ (mismatch), ’:’ (prefix/HAS match — for prefix match, follow the value with ’*’). Supported logical operators: AND, NOT (in that order of precedence). IMPORTANT: Numeric comparison operators (>, <, >=, <=) are NOT supported by the Google Admin Directory API for this endpoint and will cause a 400 Bad Request — ‘capacity’ can only be filtered by exact equality (e.g., ‘capacity=10’). Supported fields: generatedResourceName, name, buildingId, floor_name, capacity, featureInstances.feature.name, resourceEmail, resourceCategory.
string
Specifies sorting order for results. Use field names like ‘resourceId’, ‘resourceName’, ‘capacity’, ‘buildingId’, ‘floorName’ optionally followed by ’ desc’ for descending order. Multiple fields can be separated by commas (e.g., ‘buildingId, capacity desc’).
string
The unique ID for the customer’s Google Workspace account. Use ‘my_customer’ as an alias for the account’s customer ID.
string
Token for retrieving subsequent pages in paginated results. Use the nextPageToken from a previous response.
integer
Maximum number of results to return per page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_LIST_CALENDARSLists calendars accessible through the connected user’s CalendarList, returning IDs and user-specific metadata such as access role, color, visibility, selection, and reminders. Hidden calendars are omitted unless show_hidden is true; min_access_role and show_deleted provide additional filtering. Continue with page_token until next_page_token is absent; for incremental synchronization, pass next_sync_token back as sync_token. Use returned IDs, not display names, with event actions, and use GOOGLECALENDAR_GET_CALENDAR for canonical metadata about one known calendar.

Input Parameters

string
Token for the page of results to return, from a previous response.
string
Sync token from a previous list request to get only changed entries; showDeleted, showHidden, and pageToken are ignored if provided. Also ignores minAccessRole. An HTTP 410 Gone response means the token has expired; perform a full resync by omitting sync_token.
integer
Maximum calendars to return on one page. Google defaults to 100 and allows at most 250. Follow next_page_token until absent to enumerate every accessible calendar.
boolean
Include calendars not typically shown in the UI.
boolean
Include deleted calendars in the result.
string ("freeBusyReader" | "reader" | "writerWithoutPrivateAccess" | "writer" | "owner")
Minimum access role for returned calendars: ‘freeBusyReader’, ‘reader’, ‘writerWithoutPrivateAccess’, ‘writer’, or ‘owner’. freeBusyReader calendars expose only free/busy slots. Omit this filter to include every accessible role.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_LIST_SETTINGSDEPRECATED: Use GOOGLECALENDAR_SETTINGS_LIST instead. Tool to return all user settings for the authenticated user. Use when you need to retrieve calendar settings.

Input Parameters

string
Token for pagination to retrieve subsequent result pages
integer
Maximum number of settings to return

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_PATCH_CALENDARPartially updates (PATCHes) an existing Google Calendar, modifying only the fields provided. At least one of summary, description, location, or timezone must be provided. Empty strings for description or location clear them.

Input Parameters

string
New title for the calendar; cannot be an empty string when provided. At least one of summary, description, location, or timezone must be provided.
string
New geographic location of the calendar (e.g., ‘Paris, France’).
string
New IANA Time Zone Database name for the calendar (e.g., ‘Europe/Zurich’, ‘America/New_York’). Calendars duplicated via GOOGLECALENDAR_DUPLICATE_CALENDAR may default to UTC; set the correct timezone explicitly after duplication.
string
required
The unique identifier of the Google Calendar to update. Use ‘primary’ for the main calendar, or a calendar’s unique ID (typically in email format like ‘abc123@group.calendar.google.com’). IMPORTANT: This is NOT the calendar’s display name/title - use GOOGLECALENDAR_LIST_CALENDARS to find the ‘id’ field for a calendar.
string
New description for the calendar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_PATCH_EVENTUpdate specified fields of an existing event in a Google Calendar using patch semantics (array fields like attendees are fully replaced if provided); ensure the calendar_id and event_id are valid and the user has write access to the calendar.

Input Parameters

object
Input model for event source.
string ("confirmed" | "tentative" | "cancelled")
Status of the event.
string
New title for the event.
string
Color ID for the event (1-11). Use GOOGLECALENDAR_COLORS_GET to retrieve available colors.
string
New end time (RFC3339 timestamp, e.g., ‘2024-07-01T11:00:00-07:00’). Explicit timezone information (Z or an offset) is preserved; offset-less values are interpreted in timezone, or UTC when it is omitted. For all-day events, use YYYY-MM-DD format (exclusive end date). Optional when updating start_time - the original event duration will be preserved if end_time is not specified. Must be strictly after start_time; mismatched or mixed formats cause HTTP 400 timeRangeEmpty.
string
required
The unique technical identifier of the event to update. IMPORTANT: This is NOT the event title/name. Event IDs are opaque strings typically base32hex encoded (5-1024 characters using lowercase a-v and digits 0-9). For recurring event instances, the ID format is ‘baseEventId_YYYYMMDDTHHMMSSZ’ with an underscore separator (e.g., ‘abc123def456_20260115T100000Z’). To get an event ID, first use GOOGLECALENDAR_FIND_EVENT or GOOGLECALENDAR_EVENTS_LIST to search for events and retrieve their IDs. Use master event ID to update the entire recurring series; use instance ID to update only that occurrence — confirm scope before patching.
string
New geographic location (physical address or virtual meeting link).
integer
Sequence number as per iCalendar specification. Incremented on each event update.
string
IANA Time Zone Database name for start/end times (e.g., ‘America/Los_Angeles’). Interprets offset-less values and sets the display/recurrence zone; Z or numeric offsets still identify the instant. When provided without start_time or end_time, updates the display zone of an existing timed event while preserving its instants. All-day events do not have a time zone.
array
List of valid email addresses for attendees (e.g., ‘user@example.com’). Replaces existing attendees. Provide an empty list to remove all.
object
Input model for reminders.
array
RRULE, EXRULE, RDATE and EXDATE lines per RFC5545 for recurring events. Replaces existing recurrence rules if provided.
string
New start time (RFC3339 timestamp, e.g., ‘2024-07-01T10:00:00-07:00’). Explicit timezone information (Z or an offset) is preserved; offset-less values are interpreted in timezone, or UTC when it is omitted. For all-day events, use YYYY-MM-DD format. When only start_time is provided without end_time, the event’s original duration is preserved automatically.
string ("default" | "public" | "private" | "confidential")
Visibility of the event.
array
File attachments (max 25). Each with ‘fileUrl’ (required) and optional ‘title’, ‘mimeType’. Requires supportsAttachments=true.
string
required
Identifier of the calendar. Use ‘primary’ for the primary calendar of the logged-in user. To find other calendar IDs, use the calendarList.list method. Must be provided in snake_case format.
string
New description for the event; can include HTML.
string ("all" | "externalOnly" | "none")
Whether to send update notifications to attendees. Uses default user behavior if unspecified. Set explicitly to avoid unintended notifications when removing attendees or making bulk updates.
string ("opaque" | "transparent")
Whether the event blocks time on the calendar. ‘opaque’ (default) blocks time, ‘transparent’ does not.
integer
Maximum attendees in response; does not affect invited count. If more, response includes organizer only. Must be positive.
string ("needsAction" | "declined" | "tentative" | "accepted")
RSVP response status for the authenticated user. Updates only the current user’s response status without affecting other attendees. Note: RSVP is only supported for regular calendar events (eventType=‘default’); attempting to RSVP to focusTime, outOfOffice, birthday, or workingLocation events will result in an error.
object
Input model for conference data.
boolean
Whether attendees may have been omitted from the event’s representation.
boolean
Whether attendees other than the organizer can modify the event (default: false).
boolean
Whether anyone can invite themselves to the event (default: false).
object
Input model for extended properties.
boolean
Client application supports event attachments. Set to True if so.
object
Input model for focus time properties.
integer
API client’s conference data support version. Set to 1 to manage conference details (e.g., Google Meet links); 0 (default) ignores conference data. Setting to 1 enables reading/preserving conference data but does not generate a new Meet link — use GOOGLECALENDAR_UPDATE_EVENT with create_meeting_room=true to create one.
boolean
Whether attendees other than the organizer can invite others (default: true).
object
Input model for out-of-office properties.
boolean
Whether attendees can see who the event’s attendees are (default: true).
object
Input model for working location properties.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_QUICK_ADDParses natural language text to quickly create a basic Google Calendar event with its title, date, and time, suitable for simple scheduling; does not support direct attendee addition or recurring events, and calendar_id must be valid if not ‘primary’.

Input Parameters

string
required
Required natural language input describing the event. It must contain at least one non-whitespace character. Google Calendar parses it for event details like title, date, and time.
string
Identifier of the calendar for the event. Use ‘primary’ for the main calendar, or provide a specific calendar ID (e.g., email address).
string ("all" | "externalOnly" | "none")
Controls whether email notifications about the event creation are sent to attendees.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_REMOVE_ATTENDEERemoves an attendee from a specified event in a Google Calendar; the calendar and event must exist. Concurrent calls on the same event can overwrite attendee lists — apply changes sequentially per event.

Input Parameters

string
required
Unique identifier of the event. For recurring events, target the master series ID or a specific instance ID; removing an attendee from one instance does not affect other instances in the series.
string
Identifier of the Google Calendar to which the event belongs; ‘primary’ signifies the user’s main calendar.
string
required
Email address of the attendee to remove. Must match an attendee email present on the event. If no match is found, the attendee was already removed or was never on the event.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_SETTINGS_GETTool to return a single user setting for the authenticated user. Use when you need to retrieve a specific calendar setting value.

Input Parameters

string
required
The identifier of the user setting to retrieve. Valid values include: autoAddHangouts, dateFieldOrder, defaultEventLength, format24HourTime, hideInvitations, hideWeekends, locale, remindOnRespondedEventsOnly, showDeclinedEvents, timezone, useKeyboardShortcuts, weekStart

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_SETTINGS_LISTLists the authenticated user’s calendar settings, returning a page of settings identified by their id fields. Supports pagination and incremental synchronization using a sync token.

Input Parameters

string
Token specifying which result page to return.
string
Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of this list request contain only entries that have changed since then. If the syncToken expires, the server will respond with a 410 GONE response code and the client should clear its storage and perform a full synchronization without any syncToken.
integer
Maximum number of entries returned on one result page. By default the value is 100 entries. The page size can never be larger than 250 entries.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_SETTINGS_WATCHWatch for changes to Settings resources.

Input Parameters

string
required
A UUID or similar unique string that identifies this channel.
string
required
The type of delivery mechanism used for this channel. Must be “web_hook”.
string
An arbitrary string delivered to the target address with each notification delivered over this channel.
object
Additional parameters controlling delivery channel behavior.
string
required
The address where notifications are delivered for this channel.
integer
Unix timestamp in milliseconds specifying when the API should stop sending notifications for this channel.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_SYNC_EVENTSDeprecated: Retrieves a page of Google Calendar events for full or incremental synchronization, using a sync token for changes. Returns pagination and sync tokens; an expired token requires a new full synchronization.

Input Parameters

string
Token for paginating results, from a previous response’s nextPageToken. Repeat with each returned nextPageToken until no nextPageToken is returned; stopping early silently omits remaining events.
string
Token for incremental sync, retrieving only changes since issued. A 410 GONE response indicates an expired token, requiring a full sync. Cannot be combined with timeMin, timeMax, orderBy, query, or updatedMin; mixing these causes the request to fail.
string
Google Calendar identifier; ‘primary’ refers to the authenticated user’s main calendar.
array
Filters events by specified types (e.g., ‘default’, ‘focusTime’, ‘outOfOffice’, ‘workingLocation’). All types returned if omitted.
integer
Max events per page (max 2500); Google Calendar’s default is used if unspecified.
boolean
If True, expands recurring events into individual instances (excluding master event); otherwise, Google’s default handling applies.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLECALENDAR_UPDATE_EVENTReplaces an existing Google Calendar event using its event ID and required start time. Omitted fields can be cleared, but existing conference data is preserved by default when available; supply the desired event details for the replacement.

Input Parameters

string
Summary (title) of the event.
string
required
REQUIRED. The unique identifier of the event to update. This parameter is MANDATORY - events cannot be updated by title, date, or other criteria. You MUST first retrieve the event_id by using GOOGLECALENDAR_FIND_EVENT or GOOGLECALENDAR_EVENTS_LIST to search for the event, then use the returned ‘id’ field here.
string
Geographic location of the event as free-form text.
string
IANA timezone name from the timezone database (e.g., ‘America/New_York’, ‘Europe/London’, ‘Asia/Jerusalem’, ‘UTC’). Required if datetime is naive. For recurring events, start and end must include a timeZone. If not provided, UTC is used. If datetime includes timezone info (Z or offset), this field is optional and defaults to UTC. IMPORTANT: Must be a valid IANA timezone identifier. Values like ‘EST’, ‘PST’, ‘ISRAEL TIME’, or other abbreviations are NOT valid IANA timezone names.
array
List of attendees. Each attendee can be either: (1) A string email address (e.g., ‘user@example.com’), or (2) An object with ‘email’ (required), ‘optional’ (boolean, default false), ‘displayName’ (string), ‘comment’ (string), ‘additionalGuests’ (integer), and ‘resource’ (boolean). To mark an attendee as optional (not required), use object format: {‘email’: ‘user@example.com’, ‘optional’: true}. IMPORTANT: Only valid email addresses are accepted. Plain names cannot be used.
string ("birthday" | "default" | "focusTime" | "outOfOffice" | "workingLocation")
Type of the event, immutable post-creation. ‘workingLocation’ (REQUIRES Google Workspace Enterprise). Note: ‘fromGmail’ events cannot be created via API.
array
List of RRULE, EXRULE, RDATE, EXDATE lines for recurring events. Supported frequencies: DAILY, WEEKLY, MONTHLY, YEARLY. For recurring events, start.timeZone and end.timeZone must be present. UNTIL values follow RFC 5545: date-only (YYYYMMDD) for all-day events, or UTC datetime with Z suffix (YYYYMMDDTHHMMSSZ) for timed events. UNTIL values with time but missing Z suffix are auto-corrected. Provide an empty list to remove recurrence so the event becomes non-recurring.
string ("default" | "public" | "private" | "confidential")
Event visibility: ‘default’, ‘public’, ‘private’, or ‘confidential’.
string
Identifier of the Google Calendar where the event resides. The value ‘primary’ targets the user’s primary calendar.
string
Description of the event. Can contain HTML. Optional. Must be omitted for ‘birthday’ event type.
string
Event end time in ISO 8601 format: YYYY-MM-DDTHH:MM:SS. When provided, this parameter takes precedence over event_duration_hour and event_duration_minutes. If not provided, the end time is calculated using start_datetime + duration. Must be after start_datetime. Explicit timezone information (Z or an offset) is preserved; offset-less values are interpreted in timezone, or UTC when it is omitted.
string ("all" | "externalOnly" | "none")
Options for who should receive notifications about event changes.
string ("opaque" | "transparent")
‘opaque’ (busy) or ‘transparent’ (available).
string
required
REQUIRED. Event start time in ISO 8601 format: YYYY-MM-DDTHH:MM:SS. IMPORTANT: Natural language expressions like ‘tomorrow’, ‘next Monday’, ‘2pm tomorrow’ are NOT supported and will be rejected. You must provide the exact date and time in ISO format. Explicit timezone information (Z or an offset) is preserved; offset-less values are interpreted in timezone, or UTC when it is omitted. Examples: ‘2025-01-16T13:00:00’, ‘2025-01-16T13:00:00Z’, ‘2025-01-16T13:00:00-05:00’.
boolean
If True, guests can modify the event.
object
Properties for birthday events.
boolean
Defaults to True. When True, for CREATE operations creates a Google Meet link; for UPDATE operations preserves existing conference data if present, or adds a new Meet link if none exists. Google Workspace accounts will successfully receive a Meet link. Personal Gmail accounts and other unsupported accounts will gracefully fallback to creating an event without a Meet link when conference creation fails. Set to False to skip Meet link operations (won’t create new or modify existing conference data). The fallback ensures event creation succeeds even when conference features are unavailable due to account limitations.
integer
Number of hours for the event duration. Supports multi-day events (e.g., 240 hours = 10 days). For durations under 1 hour, use event_duration_minutes instead. Ignored if end_datetime is provided.
object
Extended properties of the event for storing custom metadata. Contains ‘private’ (visible only on this calendar) and/or ‘shared’ (visible to all attendees) dictionaries mapping string keys to string values. Example: {‘private’: {‘key1’: ‘value1’}, ‘shared’: {‘key2’: ‘value2’}}
object
Properties for focusTime events. REQUIRES Google Workspace Enterprise account with Focus Time feature enabled.
boolean
Whether attendees other than the organizer can invite others to the event.
object
Properties for outOfOffice events.
integer
Duration in minutes (0-59 ONLY). NEVER use 60+ minutes - use event_duration_hour=1 instead. Maximum value is 59. Combined duration (hours + minutes) must be greater than 0. Ignored if end_datetime is provided.
boolean
Whether attendees other than the organizer can see who the event’s attendees are.
object
Properties for workingLocation events. REQUIRES Google Workspace Enterprise. Constraints discovered from testing: - Must set transparency=‘transparent’ and visibility=‘public’ - Description must be omitted - Depending on ‘type’, include one of ‘homeOffice’, ‘officeLocation’, or ‘customLocation’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not

Triggers

Slug: GOOGLECALENDAR_ATTENDEE_RESPONSE_CHANGED_TRIGGERType: pollPolling trigger that fires when any attendee’s RSVP changes to accepted, declined, or tentative. Returns attendee info and current status.

Configuration

string
The unique identifier for the calendar
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
boolean
Whether to include deleted events in the results

Payload

string
Email of the attendee whose RSVP changed
string
Display name of the attendee
string
required
The calendar identifier
Link to the event in Google Calendar
string
required
The unique identifier of the event
string
Event title/summary
string
Previous RSVP status
string
required
Current RSVP status (accepted, declined, tentative)
Slug: GOOGLECALENDAR_EVENT_CANCELED_DELETED_TRIGGERType: pollTriggers when a Google Calendar event is cancelled or deleted. Returns minimal data: event_id, summary (if available), and cancellation timestamp.

Configuration

string
The unique identifier for the calendar to monitor
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.

Payload

string
Cancellation timestamp (from event.updated)
string
required
The unique identifier of the event
string
Event title/summary (may be missing for cancelled events)
Slug: GOOGLECALENDAR_EVENT_STARTING_SOON_TRIGGERType: pollTriggers when a calendar event is within a configured number of minutes from starting. Returns event details, time remaining, attendees, and join links when available.

Configuration

string
The unique identifier for the calendar to monitor
integer
Look-ahead window (in minutes) for upcoming events to evaluate
boolean
Whether to consider all-day events (default False)
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
integer
Trigger when an event is within this many minutes from starting

Payload

array
List of attendees
string
required
The calendar identifier
integer
required
Countdown window used for this trigger
string
Email of the event creator
string
Event description
string
required
The unique identifier of the event
Google Meet link for the conference, if available
Link to the event in Google Calendar
string
Event location
number
Minutes remaining until event starts (>= 0)
string
Email of the event organizer
string
Event start time in ISO format
number
Event start time as UNIX epoch timestamp (UTC)
string
Event title/summary
Slug: GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_CHANGE_TRIGGERType: webhookSOON TO BE DEPRECATED - Use Calendar Event Sync (polling trigger) instead. Real-time webhook trigger for calendar event changes. Returns event metadata only. For full event data, use Calendar Event Sync (polling trigger).

Configuration

string
The unique identifier for the calendar
integer
The time-to-live in seconds for the notification channel

Payload

string
required
The unique identifier passed to identify this channel
string
required
The unique identifier of the resource
string
required
The state of the resource
string
required
The url for the resource
Slug: GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_CREATED_TRIGGERType: pollPolling trigger that fires when a new calendar event is created. Returns event ID, summary, start/end times, and organizer info.

Configuration

string
The unique identifier for the calendar
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
boolean
Whether to include deleted events in the results

Payload

string
required
The calendar identifier
string
Event end time in ISO format
string
required
The unique identifier of the event
string
Email of the event organizer
string
Name of the event organizer
string
Event start time in ISO format
string
Event title/summary
Slug: GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_SYNC_TRIGGERType: pollPolling trigger that returns full event data including details, attendees, and metadata. For real-time notifications with basic info, use Calendar Event Changes (webhook).

Configuration

string
The unique identifier for the calendar
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
boolean
Whether to include deleted events in the results

Payload

array
List of attendees
string
required
The calendar identifier
object
Conference data structure containing details about the meeting
string
When the event was created
string
Email of the event creator
string
Name of the event creator
string
Event description
string
Event end time in ISO format
string
required
The unique identifier of the event
string
required
Type of change: created, updated, or deleted
Google Meet link for the conference, if available
Link to the event in Google Calendar
string
Event location
string
Email of the event organizer
string
Name of the event organizer
string
ID of recurring event if applicable
string
Event start time in ISO format
string
Event status (confirmed, tentative, cancelled)
string
Event title/summary
string
When the event was last updated
string
Event visibility
Slug: GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_UPDATED_TRIGGERType: pollTriggers when an existing Google Calendar event is modified. Returns the event ID, change type, and the specific fields that changed with their previous and new values.

Configuration

string
The unique identifier for the calendar
number
Deprecated: use polling_interval on the trigger instance instead. Minutes between checks for new events.
boolean
Whether to include deleted (cancelled) events in the results
array
List of event fields to track for changes. start and end are compared as RFC3339 strings (preferring dateTime over date). Attendees are compared by email, displayName, responseStatus, and optional flag.

Payload

string
required
The calendar identifier
string
Type of change. Always ‘updated’ for this trigger
string
required
The unique identifier of the event
string
When the event was last updated (RFC3339)
object
required
Dictionary of changed fields with old and new values