Overview
This node manages Microsoft Graph webhook subscriptions specifically for Outlook Groups. It allows users to create, update, delete, and list webhook subscriptions that notify external services about changes in Outlook Group conversations.
Common scenarios include:
- Automatically receiving notifications when new conversations are created in a specific Microsoft 365 group.
- Updating existing webhook subscriptions to change the notification URL or extend their expiration.
- Deleting obsolete subscriptions to stop receiving notifications.
- Listing all active subscriptions to monitor or audit webhook configurations.
Practical example: A user wants to trigger an automation workflow whenever a new conversation is started in a particular Microsoft 365 group. They can use this node to create a subscription with a webhook URL pointing to their automation endpoint, ensuring real-time updates.
Properties
| Name | Meaning |
|---|---|
| Operation | The action to perform: 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 where notifications will be sent when events occur. |
| Subscription ID | (Update, Delete) The identifier of the subscription to modify or remove. |
| Expiration Hours | (Create, Update) Duration in hours the subscription remains active (max 4230 hours). |
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 API, including subscription ID, resource, expiration time, etc.
- Update Subscription: Returns the updated subscription object.
- Delete Subscription: Returns a success message confirming deletion along 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 authentication token credential configured for Microsoft Graph API access with permissions to manage subscriptions and read groups.
- Uses Microsoft Graph API endpoints under
/groupsand/subscriptions. - The node dynamically loads available Microsoft 365 groups for selection during subscription creation.
Troubleshooting
- Error loading groups: If the node cannot load Microsoft 365 groups, verify that the API credentials have sufficient permissions and that the Microsoft Graph API is reachable.
- Subscription creation/update errors: Common issues include invalid webhook URLs, exceeding maximum expiration time (4230 hours), or insufficient permissions. Ensure the webhook URL is publicly accessible and the token has subscription management rights.
- Deletion failures: Confirm the subscription ID exists and belongs to the authenticated tenant.
- General API errors: Check network connectivity, API throttling limits, and correct configuration of credentials.
If the node throws errors, enabling "Continue On Fail" can help process multiple items without stopping on the first failure.