Outlook Group Mailbox Trigger

Uruchamia workflow po nadejściu nowej wiadomości do Microsoft 365 Group mailbox

Overview

This node is a trigger for new messages arriving in a Microsoft 365 Group mailbox (Outlook Groups). It continuously polls the specified group mailbox and activates the workflow whenever a new message matching optional filters arrives. This is useful for automating processes based on group email activity, such as monitoring team communications, triggering alerts on important emails, or processing incoming requests sent to a shared mailbox.

Practical examples:

Automatically create support tickets when an urgent email arrives in a support group mailbox.
Notify a Slack channel when a message with attachments is received by a project group.
Archive or process emails from specific senders or containing certain keywords in the subject.

Properties

Name	Meaning
Group Mailbox	Select the Microsoft 365 Group mailbox to monitor for new messages. Only unified groups are listed.
Include Attachments	Whether to include all attachments of the new messages as binary data in the output. If enabled, attachments will be available as separate binary properties.
Filtry (Filters)	Collection of optional filters to narrow down which messages trigger the workflow:
- Subject contains	Filter messages whose subject contains the specified string (case-insensitive). Examples: "urgent", "meeting".
- From email address	Filter messages sent from the exact specified email address.
- From contains	Filter messages where the sender's email or name contains the specified substring. Examples: "john", "manager", "@company.com".
- Recipient address	Filter messages originally sent to the specified recipient email address.
- Has attachments	Filter messages that have attachments.
- Attachment's extensions	Filter messages that contain at least one attachment with one of the specified file extensions (comma-separated list, e.g., "pdf,xlsx,jpg").

Output

The node outputs an array of new messages matching the criteria. Each item has the following JSON structure:

id: The unique ID of the message.
conversationId: The conversation the message belongs to.
threadId: The thread within the conversation.
topic / subject: The topic or subject of the message.
body: The content of the message.
from: Information about the sender.
to: Details about recipients including the group ID and original recipients.
receivedDateTime: Timestamp when the message was received.
hasAttachments: Boolean indicating if the message has attachments.
attachments: Array of attachment metadata objects (id, name, contentType, size, contentBytes if available).
event: Always "newMessage" indicating the type of event.
isNew: Always true for new messages.
triggerTime: Timestamp when the trigger fired.
isTestRun: Boolean flag indicating if this is a test run.

If Include Attachments is enabled, attachments are also included as binary data properties named data, attachment_1, attachment_2, etc., each containing the raw file data, MIME type, filename, and size.

Dependencies

Requires a valid Microsoft 365 API authentication credential with permissions to access Microsoft 365 Groups mailboxes.
Uses Microsoft Graph API endpoints to fetch groups, conversations, threads, posts, and attachments.
The node relies on polling to detect new messages; no webhook support is implemented.
Requires n8n environment configured with the appropriate API credentials.

Troubleshooting

No groups listed: Ensure the API credential has permission to read Microsoft 365 Groups and that there are unified groups available.
"Nie wybrano Group Mailbox." error: This means no group mailbox was selected. Select a valid group mailbox in the node settings.
Failed to check messages: Indicates an issue calling the Microsoft Graph API. Check network connectivity, API permissions, and credential validity.
Test timeout - no new messages found: During manual test mode, if no new messages arrive within 60 seconds, the node returns a timeout message. To resolve, send a new message to the monitored group mailbox.
Attachment loading errors: If attachments fail to load, verify that the account has access to the attachments and that the attachments exist.