Outlook Groups icon

Outlook Groups

Interact with Microsoft Outlook Groups and SharePoint

Overview

The node interacts with Microsoft Outlook Groups, specifically providing operations for calendar management among other resources. For the Calendar resource and the Get Events operation, it retrieves a list of events from a selected calendar in the user's Microsoft 365 account.

This node is useful when you want to automate workflows involving calendar data, such as fetching upcoming meetings or events to process them further, send notifications, or integrate with other systems.

Practical example:

  • Automatically retrieve all events from a specific calendar to generate daily schedules.
  • Sync calendar events with another application or database.
  • Trigger actions based on upcoming events fetched from the calendar.

Properties

Name Meaning
Calendar The calendar from which to fetch events. This is selected from available calendars in the user's Microsoft 365 account.

The property is an option selector populated dynamically by the method getCalendars, which fetches the list of calendars accessible to the user.

Output

The output is an array of JSON objects, each representing a calendar event retrieved from the specified calendar. Each event object corresponds to the structure returned by the Microsoft Graph API for calendar events, typically including fields like:

  • id: Event identifier
  • subject: Title of the event
  • start and end: Start and end date/time of the event
  • location: Location details
  • body: Description or content of the event
  • Other metadata such as attendees, importance, reminders, and status

No binary data output is involved in this operation.

Dependencies

  • Requires an authenticated connection to Microsoft Graph API with permissions to access the user's calendars.
  • The node depends on an API key credential (or OAuth token) configured in n8n to authenticate requests to Microsoft Graph.
  • The dynamic loading of calendar options requires proper API permissions to list calendars.

Troubleshooting

  • Common issues:

    • No calendars found: This may happen if the authenticated user has no calendars or lacks permission to read calendars.
    • API authentication errors: Ensure that the API credentials are valid and have the necessary scopes/permissions.
    • Network or API rate limits: Temporary failures might occur due to network issues or throttling by Microsoft Graph.
  • Error messages:

    • Errors thrown by the Microsoft Graph API will be surfaced, often including HTTP status codes and error messages.
    • If the node fails to parse or retrieve calendars, it returns messages like "No calendars available" or permission-related errors.
    • To resolve, verify credentials, permissions, and connectivity.

Links and References

Discussion