Is important - Automate.ax

isImportant checks whether one Gmail message has the IMPORTANT system label. Use it when an automation should branch on Gmail’s current importance state.

Example

Remove the importance marker from newly received messages that Gmail considers important:

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

export default automation("Clear Gmail importance markers", () => {
  const email = onNewEmail()
  const important = isImportant({ messageId: email.messageId })

  branch(important, () => {
    unmarkAsImportant({ messageIds: email.messageId })
  })
})

Inputs

Name	Type	Required	Description
`messageId`	`string`	Yes	Immutable Gmail message ID to inspect.
`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 email.messageId directly.

Output

The action returns a Signal<boolean> indicating whether the message has Gmail’s IMPORTANT label when the action runs. Importance is message-level. Gmail can add or remove this label through its own importance classification, independently of your automation.

⌘I