# Move Mail Message

This action moves one or more messages from a source email folder to a destination email folder.

## **Properties**

![](/files/-MfgPwh_ZkvHT2FI_03Z)

### **Input**

* **Input**: the message to be moved / name of the mail message variable being targeted.
* **Server Address**: URL of the target email server; e.g. mail.tailent.com.
* **Port**: port of target mail server; e.g. 994.
* **Use SSL**: specifies if the connection should use SSL.
  * True
  * False
* **Username**: email username e.g. <john.doe@tailent.com>.
* **Password**: converted from plain text to secured text.

![](/files/-MfgQ5sUbhPL0bnt2wCQ)

* **Source Folder:** email source folder(from where the message will be moved); e.g. Inbox.
* **Destination Folder**: email folder where the message will be moved; e.g. Invoices\_Processed.

### &#x20;

{% hint style="info" %}
for Source Folder and Destination folder:  according to standard IMAP protocol, the default value is INBOX; Subfolders can be accessed only using the format INBOX.FolderName.

Please check [this article](/getting-started/tap-studio/outlook-vs-standard-imap-protocol.md) about the differences between Outlook and standard IMAP protocol.
{% endhint %}

### **Misc**

* **Display Name**: action display name in your implementation project
* **Wait Before**: number milliseconds robot to wait before executing the action.
* **Wait After:** number milliseconds robot to wait until moving to the next action.
* **Abort on Error**: True/False
* **Retry Times**: Specifies the number of times to retry an action if it doesn't end successfully. Default value 0 (no retry); Use -1 if you want to retry indefinitely.&#x20;

## **Use Case**

### **Potential Use Cases**

* Move emails containing tasks, once the task was executed successfully
* Move emails containing invoices from suppliers, once the invoice was introduced in the ERP
* Move emails containing orders once the Purchase Order (PO) was registered in the ERP and invoice was generated

### **Examples of Using Get Email Messages**

**Example**

In this example, the robot will move an email containing an invoice from the Outlook folder "InvoicesUNprocessed" to the folder "InvoicesProcessed".

**Prerequisites:**

* Outlook Online
* Review [Get Email Messages](/actions/tap-actions/mail/get-email-messages.md)

Watch the robot in action:

{% embed url="<https://www.youtube.com/watch?v=VR2imDfAqjw&feature=emb_title>" %}

You can see how **Move Mail Message** activity is used in an example that incorporates multiple activities. You can check and download the example from here:

{% file src="/files/-MT5eJwsac9qx9TMjeId" %}
Move Email Message sample project
{% endfile %}

The article doesn't fully answer your question, or you want to find out more? Ask your question in the comments, on our community forum, or contact our support team or your account manager. Whatever works for you, your question will find its answer soon!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tailent.com/actions/tap-actions/mail/move-mail-message.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.