Mark as important - Automate.ax

markAsImportant adds Gmail’s IMPORTANT system label to one or many messages. Use it to surface automation-selected mail in Gmail’s Important view.

Example

Mark newly received messages from a billing system as important:

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

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

  markAsImportant({ messageIds: email.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 passes the filtered message ID signal directly.

Output

The action returns a Signal<string[]> containing 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.

⌘I