Email Receiver

Email Receiver is an event source. It polls the mailbox on an IMAP resource and starts a workflow for each message that passes its filters.

After Processing decides what happens to a message once its workflow has run — marked read, deleted, moved to another folder, or left untouched. Choosing an action here is what stops the same message being picked up on the next poll.

Attachments are inlined as base64 up to Inline Attachment Max (bytes). Anything larger is flagged truncated in the output rather than inlined.

The activity has three tabs: Configuration, Advanced, and Output.

Configuration

Field	Required	Description
Name	Optional	Name of the component.
Description	Optional	Description of the component.
IMAP Connection	Optional	The IMAP or POP3 mailbox resource to poll.
Folder	Optional	Folder to poll. Defaults to INBOX. Blank uses the connection's default folder.
After Processing	Optional	Mark as read, Delete, Move to folder, or Leave as-is. Defaults to Mark as read.

Choosing Move to folder requires Move To Folder on the Advanced tab.

Advanced

Field	Required	Description
Start Position	Optional	On first activation, skip existing mailbox messages or drain the current backlog. New messages only or All existing messages. Defaults to New messages only.
Unseen Only	Optional	Fetch only unseen messages. Defaults to cleared.
Poll Interval (s)	Optional	Defaults to 30.
Batch Size	Optional	Maximum messages processed per poll. Defaults to 25.
Download Attachments	Optional	Defaults to selected.
Inline Attachment Max (bytes)	Optional	Attachments up to this size are inlined as base64; larger ones are flagged truncated. Defaults to 262144.
From Contains	Optional	Only deliver messages whose From contains this text.
Subject Contains	Optional	Only deliver messages whose Subject contains this text.
Move To Folder	Optional	Target folder when After Processing is Move to folder.

Output

Field	Data Type	Description
messageId	String	Message-ID header value when present.
from	String	Sender address from the From header.
to	Array	Recipients from the To header.
cc	Array	Recipients from the Cc header.
subject	String	Email subject.
date	String	Sent date, ISO-8601.
headers	Object	All headers as key-value pairs.
message	String	Plain-text body parsed from the text/plain MIME part, when present.
html	String	HTML body parsed from the text/html MIME part, when present.
attachments	Array	Attachments and inline parts extracted from the message.

attachments

Field	Data Type	Description
name	String	Attachment filename.
contentType	String	Attachment content type.
size	Integer	Attachment size.
contentBase64	String	Present when the attachment was inlined, meaning it was within Inline Attachment Max (bytes).
truncated	Boolean	True when the attachment exceeded the inline cap and was not downloaded.
cid	String	Content-ID for inline images.