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
| Input | Type | Description | Default |
|---|---|---|---|
| Run | Event | Triggers the node to mark the specified message as read. | - |
| Message ID | Text | The 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. | - |
| Connections | Connection | The Gmail connection to use for this operation. Configure this in the properties panel. | - |
Outputs
| Output | Type | Description |
|---|---|---|
| Done | Event | Fires when the operation completes, regardless of success or failure. |
| Status | Data | Contains '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:
- Use Gmail Search Emails to find unread messages matching specific criteria.
- Pass the
messageIdfrom the search results into the Message ID input of this node. - Trigger the Run event to mark the message as read.
- Use the Done event to trigger subsequent workflow steps (e.g., moving the message to another folder or logging the action).