{{ transformations:emailcommandaction.png}}
====== EMAIL COMMAND ======
Category: Workflow / External\\

\\ 
=====Description=====
This action performs various operations on email messages.

\\
=====Capabilities====
  *List folders
  *Mark as read
  *Mark as unread
  *Delete
  *Delete permanently
  *Move to folder

\\ 
=====Action settings=====
^ Setting  ^ Description  ^
|Connector<sup>*</sup>|Select or create a connector to the email account to perform operations on.|
|Command|Select the operation to perform on the email messages.  Options:  //List folders//, //Mark as read//, //Mark as unread//, //Delete//, //Delete permanently//, or //Move to folder//.|
|Message IDs|Select the column from the incoming dataset that contains the Message IDs of the emails to operate on.|
|Folder<sup>*</sup>|Select the folder containing the emails to operate on.  Options:  //Incoming// or //Other// (and enter or browse to the desired folder).|
|If a message does not exist or cannot be processed|Select how EasyMorph behaves when a specified email message either doesn't exist or cannot be operated on.  Options:  //Fail// (stop the workflow and display an error), //Warn// (continue the workflow and display a warning), or //Add column with operational result// (a column called //Operation result// is appended to the dataset with the result of the operation for each row).|
<sup>*</sup> Setting can be specified using a [[:parameters|parameter]].\\

\\ 
====Move to folder options====
^Option ^Description ^
|Destination folder<sup>*</sup>|Select the folder to move the specified email messages into.  Options:  //Incoming// or //Other// (and enter or browse to the\\ desired folder).|
<sup>*</sup> Setting can be specified using a [[:parameters|parameter]].\\

\\ 
=====Remarks=====
Use the [[transformations:fetchemail|Fetch email]] action to retrieve the current emails in the specified folder to operate on.  Check the //Fetch message ID// option in the Options tab to return the email messages' Message IDs.

\\ 
=====See also=====

  * [[transformations:fetchemail|Fetch email]]
  * [[transformations:sendemail|Send email]]