Mark as important - Automate.ax

gmail.markMessagesAsImportant adds Gmail’s IMPORTANT label to messages, placing them in the Important view.

Example

Mark newly received messages from a billing system as important:

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

export default automation("Prioritize billing messages", () => {
  const email = filter(
    gmail.onNewEmail(),
    (message) => message.from?.address === "billing@example.com",
  )

  gmail.markMessagesAsImportant({ messageIds: email.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 represents importance with the IMPORTANT system label. Gmail’s own importance classifier can change this state later, and the action updates only the supplied messages, not every message in their threads.