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 Microsoft 365 groups.
Common scenarios:
- Automatically receiving notifications when new conversations are created in a specific Microsoft 365 group.
- Managing the lifecycle of webhook subscriptions by updating expiration times or changing notification URLs.
- Cleaning up unused subscriptions by deleting them.
- Auditing or monitoring all active subscriptions related to Outlook Groups.
Practical example:
A team uses Microsoft 365 groups for collaboration and wants to trigger workflows whenever a new conversation starts in their group. By creating a subscription with this node, they can receive real-time notifications via a webhook URL and automate follow-up actions such as sending alerts or logging messages.
Properties
| Name | Meaning |
|---|---|
| Group ID | The Microsoft 365 group to monitor. Options are dynamically loaded from available groups. |
| Webhook URL | The URL endpoint that will receive notifications when changes occur in the monitored group. |
| Expiration Hours | Duration (in hours) for which the subscription remains active. Maximum allowed is 4230 hours. |
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 including its ID, resource, expiration time, etc.
- Update Subscription: Returns the updated subscription details.
- Delete Subscription: Returns a success message confirming deletion along with the subscription ID.
- List Subscriptions: Returns a list of all active subscriptions.
No binary data output is produced by this node.
Dependencies
- Requires an API authentication token credential configured for Microsoft Graph with permissions to manage Outlook Groups and subscriptions.
- Uses Microsoft Graph API endpoints under
/groupsand/subscriptions. - The node dynamically loads Microsoft 365 groups using the Graph API to populate the "Group ID" options.
Troubleshooting
Common issues:
- Invalid or expired API credentials causing authorization failures.
- Insufficient permissions on the Microsoft Graph API to read groups or manage subscriptions.
- Providing an invalid group ID or subscription ID.
- Exceeding maximum allowed expiration hours (max 4230).
- Network or connectivity issues reaching Microsoft Graph or the webhook URL.
Error messages and resolutions:
"Check credentials and permissions": Verify that the API key/token has correct scopes and is valid."Subscription not found": Confirm the subscription ID exists before attempting update or delete."Invalid expirationDateTime": Ensure expiration hours do not exceed the maximum limit and date format is correct."Webhook URL unreachable": Make sure the provided webhook URL is publicly accessible and correctly formatted.
Enabling "Continue On Fail" allows processing multiple items even if some fail, returning error details in the output JSON.