Outlook Groups Subscription

Overview

This node manages Microsoft Graph webhook subscriptions specifically for Outlook Groups. It allows users to create, update, delete, and list webhook subscriptions that monitor conversations within a specified Microsoft 365 group. This is useful for automating workflows triggered by new conversations or messages in Outlook Groups.

Common scenarios include:

• Automatically triggering workflows when new conversations are created in a specific Microsoft 365 group.
• Updating existing webhook subscriptions to extend their expiration or change the notification URL.
• Cleaning up unused subscriptions by deleting them.
• Retrieving all active subscriptions to manage or audit them.

For example, you can create a subscription to receive notifications whenever a new conversation is started in a team’s Outlook Group, enabling real-time processing or alerts.

Properties

Output

The node outputs JSON data representing the response from Microsoft Graph API calls related to subscriptions:

• Create Subscription: Returns the newly created subscription object with details such as subscription ID, resource, expiration time, etc.
• Update Subscription: Returns the updated subscription object reflecting changes like new expiration time or notification URL.
• Delete Subscription: Returns a success message confirming deletion along with the deleted subscription ID.
• List Subscriptions: Returns a list of all active subscriptions associated with the authenticated account.

No binary data output is produced by this node.

Dependencies

• Requires an API authentication token credential configured for Microsoft Graph API access with permissions to manage subscriptions on Outlook Groups.
• Uses the Microsoft Graph API endpoint /subscriptions to perform CRUD operations on webhook subscriptions.
• The node depends on a helper function to make authenticated HTTP requests to Microsoft Graph.

Troubleshooting

• Invalid Group ID: If the provided Group ID does not exist or the authenticated user lacks permission, the API call will fail. Verify the Group ID and permissions.
• Webhook URL Issues: The notification URL must be publicly accessible and able to respond to validation requests from Microsoft Graph. Failure to do so may cause subscription creation to fail.
• Expiration Hours Limits: The maximum allowed expiration is 4230 hours (~7 days). Setting a higher value will result in an error.
• Subscription Not Found: When updating or deleting, if the subscription ID is invalid or expired, the operation will fail.
• API Rate Limits: Frequent subscription management calls might hit Microsoft Graph API rate limits; handle errors accordingly.
• To resolve errors, check the exact error message returned in the node output and verify input parameters and API credentials.

Links and References

• Microsoft Graph Subscriptions Overview
• Create subscription - Microsoft Graph
• Update subscription - Microsoft Graph
• Delete subscription - Microsoft Graph
• List subscriptions - Microsoft Graph