[M365] M365 Inbox Watcher

Q100126: [M365] M365 Inbox Watcher

M365 Inbox Watcher trigger - fires when emails in an inbox match selection criteria.

Parameter	In/Out	Description	Other Info
Minutes between checks	In	How often to check, in minutes	Default: `10` Minimum: `1` Maximum: `10080`
OAuth Connection	In	TenantId, ClientId, and Secret used to retrieve OAuth Bearer token from Microsoft Graph.	Connection type: `sysAzureOAuth`
Email	In	Email address used for inbox search.
Trigger Once per Message	In	Set to true to fire for each message found, false to fire once for all messages.	Default: `False`
Look For	In	Choices: `Unread`, `Any` Select whether to look for unread or all messages.	Default: `Any`
From Handling	In	Choices: `None`, `Exact`, `Domain`, `RegEx` Defines the filtering type of email From items.	Default: `None`
From	In	The email address or name to filter From items by.
Subject Handling	In	Choices: `None`, `Exact`, `Contains`, `RegEx` Defines the filtering type of email Subject items.	Default: `None`
Subject	In	The subject text or pattern to filter Subject items by.
Body Handling	In	Choices: `None`, `Contains`, `RegEx` Defines the filtering type of email Body items.	Default: `None`
Body	In	The body text or pattern to filter messages Body items by.
Has Attachments	In	Choices: `Yes`, `No`, `Any` Filter messages based on whether they have attachments.	Default: `Any`
Messages Older Than Days	In	Only consider messages older than supplied value. 0 for no filter.	Default: `0`
Max Result Size	In	The maximum number of email items returned.	Default: `500` Minimum: `1` Maximum: `50000`
MessageCount	Out	The total number of messages in the inbox.
UnreadMessageCount	Out	The total number of unread messages in the inbox.
MessagesReturned	Out	The total number of messages returned up to MaxResultSize.
MessageIds	Out	The message IDs of matching messages; will contain up to MaxResultSize messages.

(Italics = required parameters)

Notes

The [M365] Inbox Watcher is a trigger that continuously monitors a Microsoft 365 mailbox and automatically fires a job when incoming emails match defined criteria.

* Periodically checks a specified Microsoft 365 inbox using Microsoft Graph.
* Searches for emails that match configurable filters such as:
	* Read or unread status
	* Sender (From)
	* Subject text or patterns
	* Body text or patterns
	* Presence of attachments
	* Message age
* When matching messages are found, the trigger starts one or more jobs.

Last Updated:

1/28/2026 4:28:26 PM