# Get Emails via IMAP Retrieve emails using the IMAP protocol.
Server[Text] Server (for example, "imap.mail.ru").
Port

[Number] Port. If not specified, the default port is used:

  • standard connection - 143,
  • secure connection - 993.
Login[Text] Login required for authentication on the server.
Password[Text/SecureString] Password required for authentication on the server.
Timeout[Number] Timeout for a response from the server. The value is specified in seconds.
SSLIndicates whether to use a secure connection.
Number of Emails[Number] The number of recent emails to be retrieved from the server.
Delete After RetrievalDelete emails from the mail server after retrieval.
Mark as ReadMark emails as read after retrieval.
Only NewRetrieve only new emails.
Sort by Date

Type of sorting by date.

Possible options:

  • NewestFirst - new messages will be first in the list;
  • OldestFirst - old messages will be first in the list.
Email Header Filter[Text] Email header filter. The filter format depends on the "Email Header Filter Type" property.
Email Header Filter Type

Type of email header filter. Possible values:

  • Contains - simple text content check (this check occurs on the server and is the fastest);
  • Wildcard - use of wildcard characters (*, ?);
  • Regex - use of regular expressions.

Wildcard and Regex filters are executed after emails are retrieved and are the most resource-intensive. It is recommended to use them only with the "Only New" property set.

Folder

[Text] Folder on the mail server for receiving mail. If the value is empty, the "Inbox" folder will be used.

If necessary, specify nested folders using the '\' character. For example, "Inbox\TestFolder".

Result[List] List of MailMessage objects that are emails with all content.
Error Handling Level

Select the error handling level. Possible values:

  • "Default" - default;
  • "Ignore" - errors are ignored;
  • "Handle" - errors are handled.

If "Default" is selected, the value from the "Start" block of this diagram will be used.

Message Level

Select the message level that blocks will output during operation. Possible values:

  • "Default" - default;
  • "Release" - output is disabled;
  • "Debug" - outputs main information;
  • "Detailed" - outputs detailed information.

If "Default" is selected, the value from the "Start" block of this diagram will be used.

Error Text[Text] Returns detailed information about the error in case of incorrect execution of the block's work.
--- # 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.sherparpa.ru/en/sherpa-rpa/sherpa-designer/spravochnik-blokov/elektronnaya-pochta-mail/poluchit-pisma-cherez-imap-getimapmailmessages.md?ask= ``` 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.