Get Calendar Events By Email

The Get Calendar Events By Email node retrieves Microsoft 365 calendar events for a specified email account. It allows for flexible date filtering and can include or exclude recurring and all-day events, control the maximum number of results, and apply sort and visibility filters.

Node Type

Task

Task Type

Get Calendar Events By Email

Purpose

Use this node to programmatically retrieve calendar events for a specific Microsoft account, with fine-grained control over filtering and result set behavior.

---

Input Fields

Required Inputs

Label	Input Type	Description
Email Account	text	The email address of the calendar to retrieve events from.
Date Filter Type	picklist	Determines how the date range should be filtered. Options: Between Dates, Last X Days, Before Date, After Date, All.

Depending on the selected Date Filter Type, additional fields become required.

If Between Dates is selected:

• Start Date (dateTime): Start of the range.
• End Date (dateTime): End of the range.

If Last X Days is selected:

• Days (text): Number of days back from today to retrieve.

If Before Date is selected:

• End Date (dateTime): Retrieve events before this date.

If After Date is selected:

• Start Date (dateTime): Retrieve events after this date.

---

Optional Inputs

Label	Input Type	Description
Calendar Name	text	Optional calendar name (default is primary calendar).
Include Recurring Events	checkbox	Whether to include recurring events.
Only All-Day Events	checkbox	Whether to include only all-day events.
Show-As Filter	picklist	Filter by availability status (Any, Busy, Free, etc.).
Max Results	text	Maximum number of events to retrieve. Default is 100.
Sort Order	picklist	Sorting order, e.g. Start Asc, Start Desc.

---

Output

Output Variable	Type	Description
Calendar Events	object	List of events retrieved from the calendar within the specified filter criteria.

---

Example Use Case

A workflow may need to fetch all meetings scheduled for a user in the past 7 days for reporting or status tracking. By selecting:

• Email Account: jane.doe@company.com
• Date Filter Type: Last X Days
• Days: 7
• Include Recurring Events: true

The node will return all matching calendar events in Calendar Events.

---

Notes

• If no valid date filter is supplied, the node will default to the current date or use failsafe values (e.g., DateTime.MinValue or DateTime.MaxValue).
• The service account used must have delegated or application permissions to read calendar events for the specified mailbox.
• Failure to retrieve events or invalid configuration will result in the node failing with a descriptive error message.