Mark as unread - Automate.ax

gmail.markMessagesAsUnread adds Gmail’s UNREAD label to messages.

Example

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

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

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

  branch(
    messages.length.transform((length) => length > 0),
    () => {
      gmail.markMessagesAsUnread({
        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.
Second argument: `{ account }`	`string \| Google account reference`	No	Google Account binding. Defaults to the project binding.

Inputs accept compatible signals.

Output

Returns a Signal<string[]> with 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.