Fetch Emails Action

Fetch Emails Action fetches emails that match the defined criteria from an IMAP email server. It supports filtering emails, optionally marking them as read, and saving attachments to a local directory. The fetched emails are returned as an array stored in an output variable.

Appearance

In Talos, Fetch Emails Action appears as a standard rectangular node with an envelope icon.

Properties

As all Actions, Fetch Emails Action has a few unique properties that are essential for its functionality.

Common properties

Common properties inherited from Action.

Display NameString

This is the display name of the action.

By customizing this property, you can differentiate between same type of actions.

Action IDString

Indicates the unique ID of this action.

This property is Read only and it is not customizable

DisabledBoolean

If set to true, this action is considered disabled and will not be executed.

FolderString

Specifies the IMAP folder to search & fetch emails from.

Read on openBoolean

Whether to change the status to read on fetch.

FiltersExpression

The filters to apply when fetching emails.

See more about Talos Scripting language & Expressions

tip

This property supports expressions. You can use variable references and expressions to dynamically build filter criteria at runtime.

Examples

Assuming a declared String variable with name senderEmail.

FROM ${senderEmail}
UNSEEN
SINCE 01-Jan-2024
SUBJECT "Monthly Report"

Save AttachmentsBoolean

Whether to save the attachments of the emails.

Attachments PathPath

The local directory to save the attached files from the fetched emails.

OutputString

The output variable name to save the emails. Returns an Array of Emails.