Outlook Groups Trigger

Triggers when new messages arrive in Outlook Groups

Overview

This node triggers workflows based on new activity in Microsoft 365 Outlook Groups. It can monitor either new messages posted to a group or new conversations started within the group. The node periodically polls the Microsoft Graph API to detect these events and outputs relevant message or conversation data.

Common scenarios include:

Automating notifications or follow-up actions when new messages arrive in a team or project group.
Tracking new conversations to initiate onboarding, logging, or analytics processes.
Integrating group discussions with other systems like CRM, ticketing, or chat platforms.

For example, you could use this node to trigger a workflow that sends a Slack notification whenever a new message is posted in a specific Microsoft 365 group.

Properties

Name	Meaning
Trigger On	Event type to trigger on: • New Message — triggers when a new message is posted to the group • New Conversation — triggers when a new conversation is started in the group
Group ID	The unique identifier of the Microsoft 365 group to monitor
Polling Interval	How often (in seconds) the node checks for new messages or conversations
Include Attachments	Whether to include message attachments in the output
Additional Fields	Optional extra parameters: • Since Date — only trigger for messages newer than this date

Output

The node outputs an array of JSON objects representing messages or conversations detected since the last poll. Each output item includes:

id: The unique ID of the message/post
conversationId: ID of the conversation the message belongs to
threadId: ID of the thread containing the message
topic: Topic of the conversation (or "No topic" if unavailable)
subject: Short preview of the message body content (first 100 characters, HTML tags removed)
body: Full message body content object
from: Information about the sender
receivedDateTime: Timestamp when the message was received
hasAttachments: Boolean indicating if the message has attachments
attachments: Array of attachment objects (if included), each with id, name, content type, size, and optionally binary content decoded from base64
event: The event type that triggered the output ("newMessage" or "newConversation")
isNew: Always true for newly detected items
triggerTime: ISO timestamp when the trigger fired

If attachments are included, their content bytes are decoded into binary buffers.

Dependencies

Requires an API authentication credential for Microsoft 365 Outlook Groups (Microsoft Graph API).
Uses Microsoft Graph API endpoints to fetch groups, conversations, threads, posts, and attachments.
The node must be configured with appropriate permissions to read group conversations and messages.

Troubleshooting

Failed to poll Outlook Groups: This error indicates issues fetching data from Microsoft Graph API. Possible causes:
- Invalid or expired API credentials.
- Insufficient permissions granted to the API token.
- Incorrect Group ID specified.
- Network connectivity problems.
To resolve, verify the API credentials, ensure the Group ID is correct, and check network access.
No new messages detected: Could be due to the polling interval being too long or no new activity since the last poll. Adjust the "Since Date" field or reduce polling interval as needed.
Attachments not included: If attachments fail to load, it may be due to permission restrictions or API limits. Check that the API token has rights to read attachments.