Get Calendar Events

The Get Calendar Events node allows you to retrieve Microsoft Outlook calendar events using a variety of date filtering options. This node connects to the Microsoft Graph API via a service account and supports recurring events, all-day event filters, and custom sorting.

---

🧩 Node Type

TaskType: Get Calendar Events
Category: Azure
Icon: (Not specified — consider adding one in the front-end JSON config.)

---

📝 Description

Use this node to retrieve calendar events from a specified Microsoft Outlook calendar. The node supports several date filtering modes such as "Between Dates", "Last X Days", "Before Date", "After Date", or "All", and allows customization of the result set including recurrence inclusion, event visibility, and sorting preferences.

---

⚙️ Input Fields

Label	Type	Description	Required	Visible When
Date Filter Type	picklist	Filter strategy for retrieving events. Options: Between Dates, Last X Days, Before Date, After Date, All.	✅ Yes	Always
Start Date	dateTime	Start date for event filtering.	✅*	Between Dates, After Date
End Date	dateTime	End date for event filtering.	✅*	Between Dates, Before Date
Days	text	Number of past days to include (e.g., 7).	✅*	Last X Days
Calendar Name	text	Name of the calendar to query. Leave blank for default.	No	Always
Email Account	text	Email address of the user’s mailbox to search.	No	Always
Include Recurring Events	checkbox	Whether to include recurring events.	No	Always
Only All-Day Events	checkbox	Filter only all-day events.	No	Always
Show-As Filter	picklist	Filter by availability. Options include: Any, Busy, Free, etc.	No	Always
Max Results	text	Maximum number of events to return. Default is 100.	No	Always
Sort Order	picklist	Sorting of events. Options: Start Asc, Start Desc, etc.	No	Always
Microsoft Service Account	service	Link to Microsoft Graph Service Account (ThirdParty-Microsoft).	✅ Yes	Always

*Required based on selected Date Filter Type.

---

📤 Output

Name	Type	Description
Calendar Events	object array	List of retrieved calendar events in structured format.

---

✅ Success Criteria

The node is marked successful if:

• A valid service account is located.
• The appropriate date filter and parameters are passed.
• Calendar events are successfully retrieved from Microsoft Graph API.

On success, Calendar Events will contain an array of event objects.

---

❌ Failure Scenarios

The node will fail if:

• Required fields based on the filter type are missing.
• The service account token is invalid or not found.
• The Microsoft Graph API returns an error or no events are returned.

---

🧪 Example Use Cases

• Retrieve upcoming meetings within the next 7 days for a user.
• Query all-day events between two specific dates.
• Filter events marked as Busy and sort by start time descending.

---

🔐 Permissions

The linked Microsoft service account must have permission to read calendar events for the target mailbox.

---

📎 Notes

• Date filtering is dynamic and supports full ISO 8601 formatting.
• Calendar Name is optional and defaults to the primary calendar if omitted.
• Events returned include metadata such as subject, start, end, isAllDay, and showAs.

---