# Get Email Messages

This action can be used to capture info about one or more email messages.

## **Properties**

### **Input**

![](/files/-MfgKrEO3sk5SAgqimFR)

* **Server Address**: URL of the target email server; e.g. mail.tailent.com.
* **Port**: port of target mail server; e.g. 994.
* **Mail Count**: number of email messages to retrieve; e.g. 30.
* **Use SSL**: specifies if the connection should use SSL.
  * True
  * False
* **Delete Messages**: specifies if the retrieved messages should be deleted or not.
  * False
  * True
* **Only Unread**: specifies if the unread messages should be retrieved.
  * False
  * True
* **Mark Read**: specifies if the retrieved messages should be marked as read or not.
  * False
  * True
* **Username**: user name for target mail account e.g. <john.doe@tailent.com>.
* **Password**: password for the target email account.
* **Folder Name**: Specifies the folder where the email messages should be retrieved from.&#x20;

{% hint style="info" %}
Default value is INBOX; Subfolders can be accessed only using the format INBOX.FolderName
{% endhint %}

{% hint style="info" %}
When accessing Microsoft Exchange mail servers, subfolders are divided using the "/" character (instead of "."). Example: **INBOX/FolderName**
{% endhint %}

### Output

![](/files/-MfgLFNUHCiOVRrIcM65)

* **Output**: the variable in which the message will be stored.

### **Misc**

![](/files/-MfgL2Ia-9pHaU5gPNW9)

* **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**

* Get an email containing a task to be performed, or a ticket to be processed by the support team (in case they don’t have a ticketing tool yet)
* Get emails containing invoices from suppliers
* Get emails from customers containing a Purchase Order (PO)

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

**Example**

In this example, the robot will get info about email messages from an inbox folder.

**Prerequisites: Outlook Online**

Watch the robot in action:

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

You can see how the **Get Email Messages** activity is used in an example that incorporates multiple activities. You can check and download the example from here:

{% file src="/files/-MT5eJwsac9qx9TMjeId" %}
Get Email Messages 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/get-email-messages.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.