Outlook Trigger icon

Outlook Trigger

Triggers when a Microsoft Graph Outlook mail notification is received.

Outlook Trigger

AI-generated

Summary

Watches a Microsoft Graph Outlook mailbox or folder for message change notifications and emits notification data to the workflow. It can manage the Graph subscription itself or receive notifications from a subscription created elsewhere.

Inputs

  • Webhook Path (required) — Unique webhook endpoint path; defaults to the node ID and should not be changed.
  • Self Subscribe — When enabled, creates and manages Graph subscriptions. Choose the current mailbox or provide an other-mailbox email and folder ID. For the current mailbox, optionally select a folder; leave it empty to watch the whole mailbox. Subscribe Subfolders includes descendant folders. Change Types defaults to created and updated; Auto Renew controls renewal from lifecycle notifications.
  • Download Full Message — Fetches the full message for non-deleted message notifications. Select Fields limits returned fields (the body is included even when omitted); Extended Property Names requests named or Graph-ID extended properties. Convert Body to Markdown adds markdownContent to HTML body fields while retaining their original content.
  • Options — Client State validates notifications against a shared secret; set it to match an externally created subscription. Use Immutable ID requests and emits immutable message IDs when available. List Attachments includes attachment metadata; Download Attachments also returns file attachment content as binary data and enables listing. Both are enabled by default.
  • Enable Message Filters — Enables filtering of resolved messages before they are emitted. Configure Message Filters with conditions using dot-notation paths such as subject or from.emailAddress.address. Filtering is only applied when Download Full Message is enabled.

Output shape

One workflow item per accepted notification, with notification fields in JSON; resolved message data is added to the message field when enabled. Attachment metadata is added to attachments, and downloaded file contents are returned as binary properties data_0, data_1, and so on.

Deleted message notifications are emitted without fetching full message data. Lifecycle notifications are handled internally and do not trigger the workflow; with Auto Renew enabled, the trigger attempts to renew its managed subscriptions. If no notifications remain to emit, the webhook returns OK without workflow items.

Links

Discussion