Skip to main content

Gmail Mark As Read

Controlled node

Overview

Marks a Gmail message as read by removing the UNREAD label from the specified message. This node requires an active Gmail connection and a valid message ID to perform the operation.

Gmail Connection Required

You must configure a Gmail connection in the node's properties panel before this node can function. The connection determines which Gmail account will be used to mark messages as read.

Inputs

InputTypeDescriptionDefault
RunEventTriggers the node to mark the specified message as read.-
Message IDTextThe Gmail message ID of the email to mark as read. This is typically obtained from the output of a Get Inbox or Search Emails node.-
ConnectionsConnectionThe Gmail connection to use for this operation. Configure this in the properties panel.-

Outputs

OutputTypeDescription
DoneEventFires when the operation completes, regardless of success or failure.
StatusDataContains 'marked as read' on success, or an error message (e.g., 'failed: [error message]') if the operation fails.

Runtime Behavior

When triggered, the node attempts to remove the UNREAD label from the specified Gmail message using the configured connection.

  • If the Message ID is missing or empty, the node will immediately fail and output 'failed: "messageId" is required' in the status.
  • On success, the status output will contain the string 'marked as read'.
  • On failure (e.g., invalid message ID, connection issues), the status output will contain 'failed: ' followed by the error message.

Example Usage

Connect this node after a Gmail Get Inbox or Gmail Search Emails node to automatically mark messages as read after processing them:

  1. Use Gmail Search Emails to find unread messages matching specific criteria.
  2. Pass the messageId from the search results into the Message ID input of this node.
  3. Trigger the Run event to mark the message as read.
  4. Use the Done event to trigger subsequent workflow steps (e.g., moving the message to another folder or logging the action).