Skip to main content
Version: Current

Mark IMAP Email Read/Unread

Description​

The Mark IMAP Email Read/Unread activity updates the read state of an email in an IMAP mailbox by setting or clearing the Seen flag for a specified message.

Common settings​

Use Process Data to bind supported inputs to workflow values or upstream outputs. See Common Activity Features for shared execution, error-handling, and output-persistence settings. Availability depends on the activity.

Design-Time Configuration​

Display Text​

Specifies the activity's display name as shown on the workflow canvas.

Connection Name​

Specifies the IMAP connection used to access the mailbox where the email resides.

Mail Folder​

Specifies the mail folder containing the email   (for example: INBOX, Sent, or Drafts).   Default value: INBOX.

Message Identifier​

Specifies the provider-specific IMAP message identifier (UID) of the email to update.   Use the MessageId value returned by the Read IMAP Email activity.

Mark As Read​

Controls whether the email is marked as read or unread.

  • true → Marks the email as Read (sets the IMAP Seen flag)
  • false → Marks the email as Unread (clears the IMAP Seen flag)

Default value: true.

Execution Control (Wait All Incoming)​

Controls how the activity behaves when multiple incoming execution paths converge.

For detailed behavior and examples, see   Execution Control – Wait All Incoming.

Error Handling (On Error)​

Defines how the workflow proceeds if the activity encounters an error.

For supported strategies (Fault, Continue, Suspend, Retry), see   On Error Handler.

Output​

Updated Email​

Returns the email whose read state was updated (if found).

The output includes the following properties:

  • From
  • To
  • Subject
  • TextBody
  • HtmlBody
  • ReceivedAt
  • MessageId
  • InternalId
  • Attachments

Example: Use a read result​

Read messages with Read IMAP Email and iterate over Emails. Bind the current email's MessageId to Message Identifier. Use the same connection and mail folder that produced the message.

Set Mark As Read to True for read or False for unread. Marking a message unread can make it eligible for a later unread-only read.

Do not bind InternalId: it contains the Internet Message-ID header rather than the mailbox lookup key. See Message identifiers. An invalid UID, inaccessible folder, or failed message lookup raises an activity error.

Help improve this page