Get Single E-mail

Activity checks the mailbox of an indicated address and reads the contents of the oldest message. Activity can delete, copy to another folder, save to drive and/or forward the message to next recipient.

Activity will read from Inbox by default. Use Include Special Folders to access the oldest message from other mailbox folders, in addition to Inbox (see a more in-depth explanation below)

Check Delete Source Message to delete message from the server and be able to read the next one.

NOTE: IMAP protocol is recommended due to POP3 protocol's limitations. Deleting an email using POP3 protocol requires a full disconnect and some servers place a limit on number of re-connects allowed in a fixed timeframe.

Check Copy to Email Folder to copy the message to Target Folder (see section Special Folders for more information). Checking both Delete Source Message and Copy to Email Folder effectively moves the message.

Check Forward Source Message and fill out Forward To, Encryption Method, Server Address and Port to forward the message to new recipient, using the outgoing server settings for the email address you are reading from.
Set Forward Timeout [s] to add a time limit for this action.

Check Save Message to save downloaded message (with attachments, if present) to hard drive. Message will be saved at Target Save Folder. Check Short Message Folder Name if resulting file path is too long for Windows requirements.

If attachment file names contain illegal characters (brackets, slashes etc), they will be replaced with an underscore.

Activity returns Message ID, Message Received Timestamp, Title (message subject), Body (message contents), From (sender), To (original recipient), CC (additional recipients), Reply To (original reply recipient), Saved Message Path and Saved Attachments Paths (paths to where message and eventual attachments were saved to hard drive)

NOTE: It's recommended that the email address is reserved for robot use.

Special Folders

Only messages in Inbox are accessed by default.

To access oldest messages in other (custom or default) folders, check Include Special Folders and provide folder name(s).

To copy a message to a folder check Copy To Email Folder and fill in the Target Folder name.

The folder names are case sensitive. For nested folders, access them as "My Folder/My Subfolder"

NOTE: Default mailbox folders can have different display names depending on language and email provider, but will need to be accessed with following keywords:

- - - "Sent" - outgoing mail
    - "Drafts" - unfinished messages
    - "Junk" - spam, unwanted messages
    - "Trash" - deleted mail

Google & Microsoft OAuth

To use the activity with a Gmail or Microsoft email follow the respective manual for setting up the account for an external application’s access.

Acquired Text	String	Output	text input by user
Alternative Scenario If Failed	Boolean	Input	checkbox; default is "on"
Application ID	String	Input	string expression from Azure Active Directory (applies to Microsoft services) or Google Cloud (applies to Google services) obtained after the application registration process
Body	String	Output	content of the message
CC	String	Output	address of the secondary recipient
Client Secret	String	Input	string expression from Google Cloud obtained after the application registration process
Delete from Server	Boolean	Input	checkbox; default is "off"
Display Name	Literal	Input	changes display name of the activity
Encryption Method	Dropdown	Input	select encryption method from the dropdown list
Exclude from Transaction Check	Boolean	Input	checkbox; default is "off"
From	String	Output	sender address
Local Folder Source Path	String	Input	path to the directory or file, where from you download email (Source: Directory/File)
Login	String	Input	login
Message Id	String	Output	message ID
Message Received Time Stamp	DateTime	Output	timestamp of received message
Password	String	Input	password (string expression)
Port	Int32	Input	port number
Protocol	Dropdown	Input	select the appropriate option from the dropdown list
Provider	Dropdown	Input	select email provider from the dropdown list
Reply To	String[]	Output	original Reply To address
Result	Boolean	Output	returns a Boolean value. True if no error in activity, otherwise will return False
Result Code	Int32	Output	Result Code will return 0 if there is no error in activity, otherwise in most cases will return 1. See the table of Extended Result Codes for more info
Save Message	Boolean	Input	checkbox; default is "off"
Saved Attachments Paths	String[]	Output	file paths to attachment files
Saved Message Path	String	Output	directory path to a file (file name and extension included)
Server Address	String	Input	address of e-mail server the robot logs on to
Short Message Folder Name	Boolean	Input	checkbox, default is "off"
Target Save Folder	String	Input	folder on computer disk where messages will be saved (direct path or variable)
Tenant ID	String	Input	string expression from Azure Active Directory obtained after the application registration process
Timeout [s]	Int32	Input	set time in seconds to connect to email server
Title	String	Output	title of the message
To	String	Output	email address of recipient
Use OAuth	Boolean	Input	checkbox; default is "off"