Get Emails By Mailbox

The Get Emails By Mailbox node allows you to retrieve emails from a specific mailbox using a Microsoft Azure service account. It supports filtering by sender, recipient, subject, and keywords, as well as limiting the results by date, folder (Inbox only), and read/unread status.

Node Category

• Category: Task
• Task Type: Get Emails By Mailbox
• Icon: mdi mdi-email

Purpose

This node is used to search and retrieve emails from a Microsoft 365 mailbox. It provides flexible filters and options for narrowing down which messages are returned. The result is stored in a variable for use in subsequent nodes.

---

Input Fields

Label	Type	Description	Required	Visible When
Service Account	text	ID of the Microsoft Azure service account to use for authentication.	Yes	Always
Email Account	text	Email address of the mailbox to search.	Yes	Always
Maximum Emails to Retrieve	number	The maximum number of emails to return (between 1 and 1000).	Yes	Always
Filter To	text	Filter emails by recipient (To field).	No	Always
Filter From	text	Filter emails by sender (From field).	No	Always
Filter Subject	text	Filter emails by subject content.	No	Always
Keywords search	text	Keywords to search within the email body.	No	Always
Inbox Folder only	boolean	If true, only emails in the Inbox will be searched.	No	Always
Unread Emails	boolean	If true, only unread emails will be retrieved.	No	Always
Date After	dateTime	Return emails received after this date.	No	Always
Date Before	dateTime	Return emails received before this date.	No	Always

---

Output

Output Variable	Description
Emails	A list of email message objects matching the filters applied.

Each email in the Emails output variable is an object containing fields such as sender, recipients, subject, body preview, and timestamp (structure depends on emailMessageSimple class).

---

Validation Rules

• Service Account must be provided and valid.
• Email Account must be a valid and accessible mailbox address.
• Maximum Emails to Retrieve must be between 1 and 1000. Any other value results in failure.

---

Remarks

• If the service account cannot be retrieved, the task will return a failure status with a descriptive message.
• This node is useful for automated processing of emails such as detecting new instructions, alerts, or incoming data based on filters.
• The node uses Microsoft Graph API via the EmailService class internally.

---