The Apple Mail Email trigger enables you to add a trigger to macOS Task Bots that starts the automation workflow when an email arrives in the mailbox configured on the Apple Mail application.

Overview

The Apple Mail Email trigger provides filter options based on which the automation workflow starts. You define filters such as sender, subject text, availability of attachments, and specific folder within the inbox. The trigger captures the incoming event payload as a Record variable in key-value pair format. Use the saved information in any subsequent actions within the session.

Settings

Mailbox
Specify the email ID of the mailbox that you want the trigger to listen for events if you have configured multiple mailboxes in Apple Mail. You can leave this field empty if you want the trigger to listen for events in the default mailbox.
Check Every
Specify the time interval for the trigger. You can configure the interval in seconds or minutes.
Select conditions
Select the appropriate filter conditions for the trigger. The following filters are available:
  • Email from: To define the filter based on the sender email address. Use a semicolon as a separator when entering multiple email addresses. This field is not case-sensitive.
  • Email subject contains: To define the filter based on the subject text. This field is not case-sensitive.
  • Email attachment: To define the filter based on attachment availability. You can choose With attachment or Without attachment
  • Email in Folder: To define the filter based on the folder rules. This option enables you to create automation when there is a folder rule in the mailbox that automatically moves the received email to a specific folder. Ensure that you enter the folder in the following format: Inbox/ABC/1 to monitor the nested folder named 1.
Note: The checkboxes with fields do not support wildcard entries.
Assign to Record
Select a record variable to save the trigger response data. The data is saved in a key-value pair format. The record variable saves the following keys:
  • emailFrom: Captures the sender email address.
  • emailTo: Captures the receiver email address.
  • emailSubject: Captures the email subject.
  • emailMessage: Captures the email body.
  • emailReceivedDate: Captures the email received date.
  • action: Captures the trigger name.