Set Gmail Read Status
The Set Gmail Read Status block updates the read or unread state of one or more Gmail messages within a workflow.
Mark Gmail messages as read or unread
The Set Gmail Read Status block updates the read or unread state of one or more Gmail messages within a workflow. It accepts a comma-separated string of Gmail message IDs and a boolean flag — true to mark messages as read, false to mark them as unread — along with a Google OAuth connection ID that authorizes the operation. The block targets one or multiple messages in a single step, making it straightforward to apply bulk status changes without looping through individual API calls.
The block returns an array of message IDs corresponding to the messages that were successfully updated. This output can be passed downstream to logging steps, conditional branches, or notification blocks to confirm which messages were affected.
This block fits into workflows that process incoming email, such as triaging support tickets, flagging messages after automated responses are sent, or resetting read status as part of a review pipeline. It is commonly paired with blocks that search or list Gmail messages, using their output IDs as input to this block.
What you can build
Real-world workflows powered by the Set Gmail Read Status block.
Auto-Mark Support Emails Read
After an AI block categorizes and routes an incoming support email, automatically mark it as read to keep the inbox organized and signal that the message has been processed.
Flag Emails After Response
Once an automated reply is sent to a customer inquiry, mark the original message as read to reflect that the thread has received a response.
Bulk Inbox Cleanup
Retrieve a list of promotional or newsletter message IDs and mark them all as read in one step to reduce unread counts without manual effort.
Reset Read Status for Review
Mark previously read messages as unread to re-queue them for human review when a follow-up action is required or an escalation is triggered.
Post-Extraction Status Update
After a workflow extracts data from an email — such as order details or form submissions — mark the message as read to prevent duplicate processing in future runs.
Audit Trail Synchronization
As part of a compliance or logging workflow, mark messages as read after their content has been archived, ensuring inbox state stays consistent with the audit record.
Ready to add Set Gmail Read Status to your workflow?
Get Started FreeCommon questions about Set Gmail Read Status
What parameters does this block require?
The block requires a messageIds field containing one or more Gmail message IDs as a comma-separated string, and a markAsRead boolean — set to true to mark messages as read or false to mark them as unread. A Google OAuth connectionId is also needed to authorize the operation.
What does the block return?
The block outputs a messageIds array containing the string IDs of all messages that were successfully updated.
Can this block update multiple messages at once?
Yes. The messageIds field accepts multiple Gmail message IDs provided as a comma-separated string, allowing the block to update the read status of several messages in a single execution.
What kinds of workflows commonly use this block?
This block is commonly used in email triage workflows, automated response pipelines, and data extraction flows where marking a message as read or unread signals that processing has occurred or that a message needs re-review.
How do I get the message IDs needed as input?
Gmail message IDs are typically produced by upstream blocks that search or list Gmail messages. The IDs from those blocks' output can be passed directly into the messageIds field of this block.
Related capabilities
[Google] Create Google Doc
Create a new Google Document and optionally populate it with content.
[Google] Update Google Doc
Update the contents of an existing Google Document.
[Google] Fetch Google Doc
Fetch the contents of an existing Google Document.
[Google] Create Google Sheet
Create a new Google Spreadsheet and populate it with CSV data.
[Google] Update Google Sheet
Update a Google Spreadsheet with new data.
[Google] Fetch Google Sheet
Fetch contents of a Google Spreadsheet range.
Add Set Gmail Read Status to your workflow
Build powerful AI workflows with drag-and-drop blocks. No coding required.