Microsoft Outlook Trigger

Type ID: microsoftOutlookTrigger  ·  Kind: Trigger  ·  Trigger style: poll  ·  Ports: 1 in, 1 out (0 in when used as the workflow's root trigger)

Polls the Microsoft Graph API on an interval and triggers the workflow when new Outlook emails matching the configured filters are received.

Credentials

Microsoft Outlook

Properties

Property	Key	Type	Required	Default	Possible values	Applies when
Poll Interval	pollIntervalMs	number	Yes	60000	Interval in milliseconds to check for new emails (minimum 60 seconds)	Always
Event	event	options	Yes	messageReceived	messageReceived (Message Received)	Always
Output	output	options	No	simple	simple (Simplified), raw (Raw), fields (Select Included Fields)	Always
Fields	fields	checkbox	Yes	[]	bccRecipients, body, bodyPreview, categories, ccRecipients, changeKey, conversationId, createdDateTime, flag, from, hasAttachments, importance, inferenceClassification, internetMessageId, isDeliveryReceiptRequested, isDraft, isRead, isReadReceiptRequested, lastModifiedDateTime, parentFolderId, receivedDateTime, replyTo, sender, sentDateTime, subject, toRecipients, webLink	output = fields
Filters	filters	object	No	{}	See sub-table	Always
Options	options	object	No	{}	See sub-table	Always

filters (object)

Property	Key	Type	Required	Default	Possible values
Only Unread	onlyUnread	boolean	No	true	Only trigger on unread emails
Sender	sender	string	No	''	Email address or name to match
Subject Contains	subjectContains	string	No	''	Text the subject must contain
Folder	folder	string	No	Inbox	Mail folder to monitor

options (object)

Property	Key	Type	Required	Default	Possible values
Mark as Read	markAsRead	boolean	No	false	Mark emails as read after triggering
Max Emails Per Poll	maxEmails	number	No	10	Max emails processed per poll (clamped to 1-50)

Notes

• If no emails match the filters within the poll window, the node returns null and the workflow does not trigger.
• onlyUnread and sender build the Graph $filter alongside the poll window; subjectContains is applied client-side (Graph can't combine $filter with $search), which temporarily raises the fetch size to 50 before trimming back to maxEmails.
• Setting folder to anything other than Inbox queries that mail folder instead of the default inbox.
• Emits one item containing emails (array) and a summary (count, subjects, senders, pollInterval, polledAt); if markAsRead is set, matched emails are marked read (best-effort).