List Events
List Google Calendar events with optional search, time range, sync, and paging.
Type
google.calendar.list_eventsFolder
google/calendarChannels
Any
Pipe
Value
Scope
Any
ServiceRequired
CapabilityRequired
Google Calendar
Listed only when a matching connected service is enabled.
List Events returns events from the connected calendar. Calendar id defaults to primary. Follow with Get Event only when you need a fresh fetch of one id; listed items already include event fields.
Search is Calendar free-text search. Type a query in one line and insert context with {{ }} (for example {{ args.email }}).
Sync token is for incremental sync. When it is set, search and time filters are ignored. Store nextSyncToken from a previous list and pass it back.
Order by start time always expands recurring events (Google Calendar requires that).
Configure
| Setting | Description |
|---|---|
| Calendar ID (optional) | Calendar id. Empty uses primary |
| Search query (optional) | Free-text search. Liquid template |
| Time min (optional) | Lower bound, RFC3339 |
| Time max (optional) | Upper bound, RFC3339 |
| Updated min (optional) | Only events changed after this RFC3339 time |
| Sync token (optional) | nextSyncToken from a previous list |
| Max results | Page size, 1–2500. Default 20 if empty |
| Page token (optional) | nextPageToken from a previous list |
| Order by | Start time or Updated. Empty uses Google’s default |
| Single events | Expand recurring events into instances |
Handles
| Handle | Role |
|---|---|
| In (target) | Incoming connection |
| Out (source) | Continues after the list returns |
Pipe schema
| Key | Type | Description |
|---|---|---|
events | list | Event objects (same shape as Create Event) |
nextPageToken | text | Pass to the next list for the following page |
nextSyncToken | text | Pass as Sync token for incremental sync |