Unmark as important - Automate.ax

unmarkAsImportant removes Gmail’s IMPORTANT system label from one or many messages. Use it when an automation has determined that mail no longer belongs in Gmail’s Important view.

Example

Clear the importance marker from newly received automated reports:

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

export default automation("Deprioritize automated reports", () => {
  const report = filter(onNewEmail(), (message) =>
    message.subject.startsWith("Automated report:"),
  )

  unmarkAsImportant({ messageIds: report.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’s own importance classifier can add IMPORTANT again later. This action changes only the supplied messages, not the other messages in their threads.

⌘I