Is important - Automate.ax

gmail.checkWhetherMessageIsImportant checks whether a message has Gmail’s IMPORTANT label.

Example

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

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

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

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

Inputs

Name	Type	Required	Description
`messageId`	`string`	Yes	Immutable Gmail message ID to inspect.
Second argument: `{ account }`	`string \| Google account reference`	No	Google Account binding. Defaults to the project binding.

Inputs accept compatible signals.

Output

Returns Signal<boolean> indicating whether the message has IMPORTANT. Importance is message-level. Gmail can add or remove this label through its own importance classification, independently of your automation.