Mark as unread - Automate.ax

markAsUnread adds Gmail’s UNREAD system label to one or many messages. Use it to return processed mail to a person’s review queue or preserve a reminder in Gmail.

Example

Mark up to 100 read messages with the Needs review label as unread:

import { automation, branch } from "automate.ax"
import { markAsUnread, searchMessages } from "automate.ax/gmail"

export default automation("Return Gmail messages for review", () => {
  const messages = searchMessages({
    limit: 100,
    query: 'label:"Needs review" is:read',
  })

  branch(
    messages.length.transform((length) => length > 0),
    () => {
      markAsUnread({
        messageIds: messages.transform((results) =>
          results.map((message) => message.messageId),
        ),
      })
    },
  )
})

Inputs

Name	Type	Required	Description
`messageIds`	`string \| string[]`	Yes	One or up to 1,000 immutable Gmail message IDs.
`account`	`string \| Google account reference`	No	Google account binding to use. Defaults to the project’s default Google account.

Every input field also accepts a compatible Signal; the example derives message IDs from searchMessages.

Output

The action returns a Signal<string[]> containing the modified message IDs in input order. Gmail stores unread state per message. Adding UNREAD to one message can make its conversation appear unread in Gmail even though other messages in the thread remain read.

⌘I