Get Emails

Retrieves email messages from the authenticated user's Microsoft 365 mailbox based on optional filters.

Purpose

Use this task when a workflow needs to read and process incoming email from a user's own mailbox. It supports filtering by sender, recipient, subject, keywords, date range, and read status, allowing workflows to act only on the messages that are relevant. The retrieved messages are stored in an output variable for downstream processing such as parsing, routing, or responding.

Inputs

Field	Type	Required	Description
Unread Emails	Checkbox	No	When checked, only unread messages are returned.
Inbox Folder only	Checkbox	No	When checked, the search is restricted to the Inbox folder.
Maximum Emails to Retrieve	Text	No	The maximum number of emails to return. Must be between 1 and 1000. Defaults to 10.
Date After	Date / Time	No	Only include emails received after this date and time.
Date Before	Date / Time	No	Only include emails received before this date and time.
Filter To	Text	No	Filter emails by the address in the To field.
Filter From	Text	No	Filter emails by the sender's address.
Filter Subject	Text	No	Filter emails whose subject contains this text.
Keywords search	Text	No	Filter emails whose body contains these keywords.

Outputs

Name	Description
Emails	A list of email message objects matching the applied filters. Each object contains message metadata such as sender, recipients, subject, and body preview. Downstream tasks can iterate over this list or inspect individual messages.