Google Workspace ListEvents
CertifiedList Google Calendar events with filters
Google Workspace ListEvents
List Google Calendar events with filters
Retrieves events from a shared calendar using time range, keyword, and pagination filters. Defaults: singleEvents true (expands recurring), showDeleted false. orderBy supports startTime (requires singleEvents) or updated; maxResults up to 2500.
type: io.kestra.plugin.googleworkspace.calendar.ListEventsExamples
id: googleworkspace_calendar_list_events
namespace: company.team
tasks:
- id: list_events
type: io.kestra.plugin.googleworkspace.calendar.ListEvents
serviceAccount: "{{ secret('GCP_SERVICE_ACCOUNT_JSON') }}"
calendarId: team@company.com
timeMin: "2025-08-10T00:00:00Z"
timeMax: "2025-08-12T00:00:00Z"
q: "standup"
singleEvents: true
orderBy: startTime
showDeleted: false
maxResults: 100
Properties
calendarId *string
Calendar ID
Email-style calendar shared with the service account, e.g. team@company.com
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150maxResults integerstring
Max results
Number of events per page (1–2500)
orderBy string
Order by
startTime (requires singleEvents=true) or updated
pageToken string
Page token
Pagination token from a previous response
q string
Keyword search
Free-text query across summary, description, and location
readTimeout integerstring
120The read timeout for the request (in seconds)
scopes array
["https://www.googleapis.com/auth/calendar"]The GCP scopes to used
serviceAccount string
The GCP service account key
showDeleted booleanstring
falseInclude cancelled
Whether to include cancelled events; default false
singleEvents booleanstring
trueReturn single instances
When true (default), expands recurring events
timeMax string
End time upper bound
RFC3339 timestamp for latest event end (timeMax)
timeMin string
Start time lower bound
RFC3339 timestamp for earliest event start (timeMin)
Outputs
events array
Matched events
io.kestra.plugin.googleworkspace.calendar.models.Event
metadataList array
Raw event metadata
nextPageToken string
Next page token
