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. This is useful for automating workflows triggered by new conversations or changes in Outlook Groups without polling the API continuously.
Common scenarios include:
- Creating a subscription to receive notifications when new conversations are created in a specific Microsoft 365 group.
- Updating an existing subscription’s expiration time or notification URL.
- Deleting a subscription when it is no longer needed.
- Listing all active subscriptions to manage or audit them.
Practical example: Automatically trigger a workflow whenever a new conversation is started in a team’s Outlook Group, enabling real-time processing or alerts.
Properties
| Name | Meaning |
|---|---|
| Operation | The action to perform on subscriptions: Create Subscription, Update Subscription, Delete Subscription, or List Subscriptions. |
| Group ID | (Create only) The Microsoft 365 group to monitor for new conversations. |
| Webhook URL | (Create, Update) The URL that will receive webhook notifications from Microsoft Graph. |
| Subscription ID | (Update, Delete) The unique identifier of the subscription to update or delete. |
| Expiration Hours | (Create, Update) Duration in hours for which the subscription remains active (max 4230). |
Output
The node outputs JSON data representing the result of the performed operation:
- Create Subscription: Returns the full subscription object as received from Microsoft Graph, including subscription ID, resource, expiration, etc.
- Update Subscription: Returns the updated subscription object.
- Delete Subscription: Returns a success message with the deleted subscription ID.
- List Subscriptions: Returns a list of all active subscriptions.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for Microsoft Graph with permissions to manage subscriptions and read Microsoft 365 groups.
- The node uses Microsoft Graph API endpoints under
/groupsand/subscriptions. - Proper permissions must be granted to the API key to create, update, delete, and list subscriptions.
- The node expects a valid webhook URL that can receive POST notifications from Microsoft Graph.
Troubleshooting
- Invalid Subscription ID: Errors occur if the subscription ID provided does not exist or is malformed. Verify the subscription ID before updating or deleting.
- Permission Denied: If the API key lacks required permissions, operations will fail. Ensure the credential has appropriate Microsoft Graph scopes.
- Webhook URL Issues: If the webhook URL is unreachable or invalid, subscription creation or updates may fail. Confirm the URL is publicly accessible and correctly configured.
- Expiration Hours Limits: Setting expiration hours beyond the maximum allowed (4230) may cause errors. Use values within the allowed range.
- API Rate Limits: Frequent subscription management calls might hit Microsoft Graph rate limits; handle errors gracefully and consider retry logic.