Notification Triggers and Actions - Mail Trigger

Monitors an email server for incoming mail and fires when email arrives.



Sets the hostname of the email server.

Polling Delay

Sets a time expression that specifies how long the mail trigger waits to poll the mail server for new email messages.


Sets the mail server port.

Username & Password

Sets the credentials to access the mail server


Sets the mail protocol used to communicate with the mail server. It can be either IMAP or POP3

Delete Processed Message

Sets whether a processed email is automatically deleted after control returns to the mail trigger. Note that when using the POP3 protocol, the JavaMail implementation does not appear to allow messages to be deleted.

IMAP Folder

Sets the name of the IMAP folder that is checked for email messages.

IMAP Folder Copy Destination

Sets the name of an IMAP folder, if any, to which a processed email is copied when the mail trigger fires.


The Mail Trigger returns its results in the flow context variable “result”. These results include information about the mail subject and its body, the addresses associated with the mail, and attachments for the mail. You can access the Mail Trigger results from the following fields:

Flow Context Variable Field Java Type Description Prescript / Postscript Example
RESULT attachments List<MailTrigger.MailAttachment> The file attachments in the mail message.
See Using MailAttachments below for more information.
List attachments = flowContext.get("RESULT").attachments; for (MailAttachment attachment : attachments) {byte[] attachBody = attachment.body; System.out.println(attachBody); }
RESULT body String The body of the mail message. String body = flowContext.get("RESULT").body; System.out.println("Message body: " + body);
RESULT cc_addresses List<String> The carbon copy recipients of the mail message. List cc_addresses = flowContext.get("RESULT").cc_addresses; for (String cc_address : cc_addresses) { System.out.println("CC: " + cc_address); }
RESULT content_type flux.notification.MailContentType The content type of the mail message. MailContentType contentType = flowContext.get("RESULT").content_type; System.out.println("Content type: " + contentType);
RESULT from_addresses List<String> The senders of the mail message. List from_addresses = flowContext.get("RESULT").from_addresses; for (String from_address : from_addresses) { System.out.println("From: " + from_address); }
RESULT reply_to_addresses List<String> The reply-to addresses of the mail message. List reply_to_addresses = flowContext.get("RESULT").reply_to_addresses; for (String reply_to_address : reply_to_addresses) { System.out.println("Reply to: " + reply_to_address); }
RESULT sent_date Date The date the mail message was sent. Date sentDate = flowContext.get("RESULT").sent_date; System.out.println("Sent date: " + sentDate);
RESULT size int The size of the mail message. int size = flowContext.get("RESULT").size; System.out.println("Size: " + size);
RESULT status_flags javax.mail.Flags Status flags for the email message. Flags statusFlags = flowContext.get("RESULT").status_flags; if (flags.getSystemFlags().contains(Flags.Flag.DELETED)) { System.out.println("Message was deleted"); }
RESULT subject String The subject of the mail message. String subject = flowContext.get("RESULT").subject; System.out.println("Subject: " + subject);
RESULT to_addresses List<String> The recipients of the mail message. List to_addresses = flowContext.get("RESULT").to_addresses; for (String to_address : to_addresses) { System.out.println("To: " + to_address); }

Passing Results with a Runtime Data Map

You can use a Runtime Data Map to copy one of the result fields into a new variable (for future reference or to reuse the data later in the workflow).

To copy a result field, you can use a data map like:

Instruction 1 of 3

Using Mail Attachments

If a message picked up by a mail trigger contains attachments, they are returned as MailAttachment objects. These objects have two fields:

Field Description Prescript / Postscript Example
body A byte[] containing the body (content) of the attachment. List attachments = flowContext.get("RESULT").attachments; for (MailAttachment attachment : attachments) { byte[] attachBody = attachment.body; System.out.println(attachBody); }
filename The filename of the attachment. List attachments = flowContext.get("RESULT").attachments; for (MailAttachment attachment : attachments) { String filename = attachment.filename; System.out.println(filename); }

You can also access the attachments through runtime data mapping. For example, you could use the following data map to pass the attachments from the mail trigger into a for each collection element action:

Instruction 2 of 3

Once the For Each Collection Element Action adds the next attachment to the flow context, you can access its fields with another data map:

Instruction 3 of 3