Email

Get Single Email

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.

To access a shared mailbox, provide the name in the Malibox Name field in addition to logging in with regular credentials.

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.

getmail1
getemail2
getemail3

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
Special Folders tooltip

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.

oauth1
oauth2
NameTypeCategoryDescription
Alternative Scenario If FailedBooleanMisccheckbox; default is "on"
Application IDStringOAuthstring expression from Azure Active Directory (applies to Microsoft services) or Google Cloud (applies to Google services) obtained after the application registration process
BodyStringOutputcontent of the message
CCStringOutputaddress of secondary recipient
Client SecretStringOAuthstring expression from Google Cloud obtained after the application registration process
Copy To Email FolderBooleanInputcheckbox; default is "off"
Delete Source MessageBooleanInputcheckbox; default is "off"
Display NameLiteralMiscchanges display name of the activity
Encryption MethodDropdownSettingsselect encryption method from the dropdown list
Exclude from Transaction CheckBooleanMisccheckbox; default is "off"
Forward EmailBooleanForwardcheckbox; default is "off"
Forward Encryption MethodDropdownForwardselect encryption method from the dropdown list
Forward PortInt32Forwardport number
Forward Server AddressStringForwardaddress of email server the robot logs in to
Forward Timeout [s]Int32Forwardset time in seconds to connect to email server
Forward ToStringForwardemail address of the recipient
FromStringOutputsender address
Include Special FoldersBooleanInputcheckbox; default is "off"
Login/Sender EmailStringSettingslogin
Mailbox NameStringSettingsname of shared mailbox
Message IDStringOutputmessage ID
Message Received Time StampDateTimeOutputtimestamp of received message
PasswordStringSettingspassword (string expression)
PortInt32Settingsport number
ProtocolDropdownInputselect the appropriate option from the dropdown list
ProviderDropdownOAuthselect email provider from the dropdown list
Reply ToString[]Outputoriginal Reply To address
ResultBooleanOutputreturns a Boolean value. True if no error in activity, otherwise will return False
Result CodeInt32OutputResult 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 MessageBooleanInputcheckbox; default is "off"
Saved Attachments PathsString[]Outputfile paths to attachment files
Saved Message PathStringOutputdirectory path to a file (file name and extension included)
Server AddressStringSettingsaddress of email server the robot logs in to
Short Message Folder NameBooleanInputcheckbox, default is "off"
Source PathStringInputpath to the directory or file, where from you download email (Source: Directory/File)
Special FoldersStringInputadditional mailbox folder(s) to check
Target FolderStringInputmailbox folder to copy email to
Target Save FolderStringInputfolder on computer disk where messages will be saved (direct path or variable)
Tenant IDStringOAuthstring expression from Azure Active Directory obtained after the application registration process
Timeout [s]Int32Settingsset time in seconds to connect to email server
TitleStringOutputtitle of the message
ToStringOutputemail address of the recipient
Use OAuthBooleanOAuthcheckbox; default is "off"