List calendar events
Lists the events in a Microsoft 365 calendar.
Settings
| Setting | What it is |
|---|---|
| ConnectionRequired | The Microsoft Graph connection the step signs in with. |
| UserRequired | A user's object id, or their sign-in address. |
| Calendar id | Leave empty for the user's default calendar. |
| Fields | text |
| Filter | An OData filter. Recurrence cannot be filtered on — expanded occurrences need a calendar view, which this node does not read. |
| Sort by | text |
| Events per call | 1 to 999. |
| Time zone | The time zone the times are given in, e.g. Europe/Amsterdam. Empty means UTC. |
| Body format | "" or "text" or "html" |
| Fetch every page | Follows Graph's own next-page link; refuses rather than truncating at Stop after. |
| Stop after | Pages — at most 50. |
| Cursor | Paste a previous run's Next cursor to read the page after it. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `microsoft-graph`) |
user | text |
calendarId | text |
select | text, by default "id,subject,start,end,location,organizer,isAllDay" |
filter | text |
orderBy | text |
top | number, by default 100 |
timeZone | text |
bodyContentType | "" or "text" or "html" |
returnAll | true/false, by default false |
maxPages | number, by default 10 |
cursor | text |
Output
| Field | Type |
|---|---|
events | array |
countEvents in this answer | number |
hasMoreMore events are waiting behind this page | boolean |
nextCursorCursor for the next page | string |
Sample output, and the expression for each field
- count0
- events[]
- hasMorefalse
Errors
When a step of this node stops a run, the run page shows a code. Look it up:
Example step
The step as a flow file holds it. Replace each value in <…>.
{
"config": {
"bodyContentType": "",
"calendarId": "",
"connection": "<connection id>",
"cursor": "",
"filter": "",
"maxPages": 10,
"orderBy": "",
"returnAll": false,
"select": "id,subject,start,end,location,organizer,isAllDay",
"timeZone": "",
"top": 100,
"user": "<user>"
},
"label": "List calendar events",
"type": "graph.listEvents",
"version": 2
}Older versions
A flow that already has this version keeps running it. A new step always gets the newest.
Version 1
| Setting | What it is |
|---|---|
| ConnectionRequired | The Microsoft Graph connection the step signs in with. |
| UserRequired | A user's object id, or their sign-in address. |
| Calendar id | Leave empty for the user's default calendar. |
| Fields | text |
| Filter | An OData filter. Recurrence cannot be filtered on — expanded occurrences need a calendar view, which this node does not read. |
| Sort by | text |
| Events per call | 1 to 999. |
| Time zone | The time zone the times are given in, e.g. Europe/Amsterdam. Empty means UTC. |
| Body format | "" or "text" or "html" |
| Fetch every page | Follows Graph's own next-page link; refuses rather than truncating at Stop after. |
| Stop after | Pages — at most 50. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `microsoft-graph`) |
user | text |
calendarId | text |
select | text, by default "id,subject,start,end,location,organizer,isAllDay" |
filter | text |
orderBy | text |
top | number, by default 100 |
timeZone | text |
bodyContentType | "" or "text" or "html" |
returnAll | true/false, by default false |
maxPages | number, by default 10 |