Skip to content
Documentation
Contact
← Back to documentation
Technical Reference

Google Calendar

Get organized and stay on schedule

CategoryProductivity
AuthenticationOAuth 2.0, custom
Version0.11.1
Published scopes3 published scopes
Last updatedSeptember 19, 2026

Overview

Connect Google Calendar with Flows360

Get organized and stay on schedule

Use the Google Calendar connector to include its declared actions and events in Flows360 workflows without duplicating the integration logic inside each consuming system. This pinned connector version currently exposes 25 actions and 7 triggers.

Available actions

  • Add Attendees to Event
  • Create Quick Event
  • Create Event
  • Get all Events
  • Update Event
  • Delete Event
  • Find Busy/Free Periods in Calendar
  • Get Event by ID
  • Plus 17 additional declared actions.

Available triggers

  • New or Updated Event
  • New Event
  • Event Ends
  • Event Start (Time Before)
  • New Event Matching Search
  • Event Cancelled
  • Plus 1 additional declared trigger.

The capability list above is generated from the exact reviewed connector package so the public description stays aligned with the version Flows360 operates.

Technical guide

Technical reference

Package identity

  • Connector: Google Calendar
  • Package: @activepieces/piece-google-calendar@0.11.1
  • Exact artifact digest: sha256:2814952819ef4fc092a2019ff00b6eb1e5e4091f5b67c30b98adcc0afc50533c
  • Runtime: Activepieces-compatible deterministic worker
  • Source: the exact reviewed Activepieces source

Authentication

OAUTH2, CUSTOM AUTH. Connection values are tenant-specific and remain in the consuming Studio instance; CDK stores definitions and field metadata, not customer credential values.

Action contracts

  • Add Attendees to Event (google-calendar-add-attendees), Add one or more person to existing event. Classification: read.
  • Create Quick Event (create_quick_event), Add Quick Calendar Event Classification: read.
  • Create Event (create_google_calendar_event), Add Event Classification: read.
  • Get all Events (google_calendar_get_events), Get Events Classification: read.
  • Update Event (update_event), Updates an event in Google Calendar. Classification: read.
  • Delete Event (delete_event), Deletes an event from Google Calendar. Classification: read.
  • Find Busy/Free Periods in Calendar (google_calendar_find_busy_free_periods), Finds free/busy calendar details from Google Calendar. Classification: read.
  • Get Event by ID (google_calendar_get_event_by_id), Fetch event details by its unique ID from Google Calendar. Classification: read.
  • Search Events Across Calendars (google_calendar_search_events_all_calendars), Searches every calendar the account can access for events matching a keyword within a required time window. Classification: read.
  • Find Free Time Slots (google_calendar_find_free_slots), Computes open time slots shared across one or more calendars within a window, by inverting their busy blocks. Classification: read.
  • List Recurring Event Instances (google_calendar_list_recurring_event_instances), Lists the individual occurrences of one recurring event series, each with its own instance event ID. Classification: read.
  • Move Event to Another Calendar (google_calendar_move_event), Moves an existing event from one calendar to another, preserving its event ID and metadata. Classification: read.
  • Create Event (google_calendar_create_event), Create a new event on a Google Calendar with structured fields (title, start/end, location, description, attendees, color) and an optional Google Meet link. Classification: read.
  • Update Event (google_calendar_update_event), Update fields of an existing Google Calendar event by ID using a safe get-then-merge; fields you leave unset keep their current values. Classification: read.
  • Delete Event (google_calendar_delete_event), Permanently delete an event from a Google Calendar by its event ID. Classification: read.
  • Get Event (google_calendar_get_event), Fetch the full details of a single Google Calendar event by its event ID. Classification: read.
  • List Events (google_calendar_list_events), List events from one Google Calendar, optionally filtered by date range, free-text search, and event types. Classification: read.
  • Find Busy Periods (google_calendar_find_busy_periods), Return the raw busy time blocks of one or more calendars within a window, via the freebusy query. Classification: read.
  • Remove Attendee (google_calendar_remove_attendee), Remove one attendee (by email) from an existing Google Calendar event, preserving the rest of the guest list. Classification: read.
  • Import Event (google_calendar_import_event), Import an existing event (by iCalUID) into a Google Calendar as a private copy, using events.import. Classification: read.
  • List Calendars (google_calendar_list_calendars), List every calendar in the user's calendar list, returning each calendar's id, summary, access role, time zone, and whether it is primary. Classification: read.
  • Get Calendar (google_calendar_get_calendar), Fetch one calendar's metadata (summary, time zone, description, location) by its calendar ID. Classification: read.
  • Get Colors (google_calendar_get_colors), Fetch the Google Calendar color palette mapping colorId values to their hex background/foreground colors. Classification: read.
  • List Settings (google_calendar_list_settings), List the user's Google Calendar account settings (time zone, week start, date/time format, and more). Classification: read.
  • Custom API Call (custom_api_call), Make a custom API call to a specific endpoint Classification: read.

Trigger contracts

  • New or Updated Event, polling.
  • New Event, webhook.
  • Event Ends, polling.
  • Event Start (Time Before), polling.
  • New Event Matching Search, polling.
  • Event Cancelled, polling.
  • New Calendar, polling.

Verification

Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Capability summary

AuthenticationOAuth 2.0, custom
Supported objects32
Supported actionsNot published
Triggers7

Authentication

Authentication method: OAuth 2.0, custom

Required scopes

https://www.googleapis.com/auth/calendar.eventshttps://www.googleapis.com/auth/calendar.readonlyemail

Authentication profiles

connection · oauth2

OAuth scopes: https://www.googleapis.com/auth/calendar.events, https://www.googleapis.com/auth/calendar.readonly, email

connection_2 · custom
  • Service Account JSON Key Required
  • User Email Optional

Supported objects

ObjectReadWriteNotes
Add Attendees to Event Yes No Add one or more person to existing event.
Create Quick Event Yes No Add Quick Calendar Event
Create Event Yes No Add Event
Get all Events Yes No Get Events
Update Event Yes No Updates an event in Google Calendar.
Delete Event Yes No Deletes an event from Google Calendar.
Find Busy/Free Periods in Calendar Yes No Finds free/busy calendar details from Google Calendar.
Get Event by ID Yes No Fetch event details by its unique ID from Google Calendar.
Search Events Across Calendars Yes No Searches every calendar the account can access for events matching a keyword within a required time window.
Find Free Time Slots Yes No Computes open time slots shared across one or more calendars within a window, by inverting their busy blocks.
List Recurring Event Instances Yes No Lists the individual occurrences of one recurring event series, each with its own instance event ID.
Move Event to Another Calendar Yes No Moves an existing event from one calendar to another, preserving its event ID and metadata.
Create Event Yes No Create a new event on a Google Calendar with structured fields (title, start/end, location, description, attendees, color) and an optional Google Meet link.
Update Event Yes No Update fields of an existing Google Calendar event by ID using a safe get-then-merge; fields you leave unset keep their current values.
Delete Event Yes No Permanently delete an event from a Google Calendar by its event ID.
Get Event Yes No Fetch the full details of a single Google Calendar event by its event ID.
List Events Yes No List events from one Google Calendar, optionally filtered by date range, free-text search, and event types.
Find Busy Periods Yes No Return the raw busy time blocks of one or more calendars within a window, via the freebusy query.
Remove Attendee Yes No Remove one attendee (by email) from an existing Google Calendar event, preserving the rest of the guest list.
Import Event Yes No Import an existing event (by iCalUID) into a Google Calendar as a private copy, using events.import.
List Calendars Yes No List every calendar in the user's calendar list, returning each calendar's id, summary, access role, time zone, and whether it is primary.
Get Calendar Yes No Fetch one calendar's metadata (summary, time zone, description, location) by its calendar ID.
Get Colors Yes No Fetch the Google Calendar color palette mapping colorId values to their hex background/foreground colors.
List Settings Yes No List the user's Google Calendar account settings (time zone, week start, date/time format, and more).
Custom API Call Yes No Make a custom API call to a specific endpoint
New or Updated Event Yes No polling trigger declared by the pinned package.
New Event Yes No webhook trigger declared by the pinned package.
Event Ends Yes No polling trigger declared by the pinned package.
Event Start (Time Before) Yes No polling trigger declared by the pinned package.
New Event Matching Search Yes No polling trigger declared by the pinned package.
Event Cancelled Yes No polling trigger declared by the pinned package.
New Calendar Yes No polling trigger declared by the pinned package.

Triggers

New or Updated Event · Poll

Triggers when an event is added or updated

Inputs

  • calendar_id · string
  • expandRecurringEvent · boolean
New Event · Webhook

Fires when a new event is created in a calendar.

Inputs

  • calendar_id · string
  • event_types · array
  • search_filter · string
  • exclude_all_day · boolean
Event Ends · Poll

Fires when an event ends.

Inputs

  • calendar_id · string
  • specific_event · boolean
  • event_id · string
Event Start (Time Before) · Poll

Fires at a specified amount of time before an event starts (e.g., a reminder).

Inputs

  • calendar_id · string
  • specific_event · boolean
  • event_id · string
  • time_value · number
  • time_unit · string
New Event Matching Search · Poll

Fires when a new event is created that matches a specified search term.

Inputs

  • calendar_id · string
  • search_term · string
  • event_types · array
  • search_fields · array
Event Cancelled · Poll

Fires when an event is canceled or deleted.

Inputs

  • calendar_id · string
  • specific_event · boolean
  • event_id · string
  • cancellation_reason · array
New Calendar · Poll

Fires when a new calendar is created or becomes accessible.

Inputs

  • access_role_filter · array
  • calendar_name_filter · string
  • exclude_shared · boolean

Setup

Setup

  1. Add the Google Calendar connector to the workflow in the target Flows360 Studio instance.
  2. Create or select the tenant-specific connection required by the connector. Connection secrets remain in the Studio connection boundary and are not copied into CDK documentation.
  3. Provide the connection fields declared by the pinned package:
  • Service Account JSON Key (serviceAccount), required.
  • User Email (userEmail), optional.

OAuth scopes

  • https://www.googleapis.com/auth/calendar.events
  • https://www.googleapis.com/auth/calendar.readonly
  • email
  1. Select the required action or trigger and complete its declared input fields. Required and optional inputs are defined by the exact package schema.
  2. Test the workflow in the appropriate environment before enabling production scheduling or event delivery.

Limitations

Limitations and operational notes

  • This content describes @activepieces/piece-google-calendar@0.11.1; provider behaviour can change independently and should be revalidated when the provider or connector version changes.
  • Only the 25 actions and 7 triggers declared by this pinned package are represented here.
  • Tenant credentials and connection values are not stored in the public connector record.
  • Provider-side permissions, account entitlements, quotas and rate limits remain subject to the connected provider account and are not inferred when the package does not declare them.
  • Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Troubleshooting

Why canu2019t the connector authenticate?

Check the tenant connection in Studio and confirm every required Google Calendar connection field is present. Re-authorise OAuth-based connections if the provider token or consent has expired. Do not place credential values in CDK content or logs.

Why is an action or trigger unavailable?

Confirm that the workflow is using @activepieces/piece-google-calendar@0.11.1 and compare the requested capability with the declared action and trigger list for this version. A capability that is not declared by the pinned package should not be presented as supported.

What should I check after a provider-side change?

Revalidate authentication, required fields, action/trigger behaviour and provider documentation before publishing refreshed connector content or moving a new package version into production.

github.com