Mark as spam - Automate.ax

markAsSpam adds Gmail’s SPAM system label and removes INBOX in one request. Use it when your automation has positively identified unwanted mail.

Example

Move newly received messages with a known unwanted subject marker to Spam:

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

export default automation("Move unwanted Gmail messages to Spam", () => {
  const unwanted = filter(onNewEmail(), (message) =>
    message.subject.includes("[UNWANTED]"),
  )

  markAsSpam({ messageIds: unwanted.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. This action requests both state changes together: add SPAM and remove INBOX. It does not delete the messages or remove unrelated labels. Use markAsNotSpam to reverse these two mailbox changes.

⌘I