Move to inbox - Automate.ax

gmail.moveMessagesToInbox adds Gmail’s INBOX label to messages.

Example

Return up to 100 archived messages with the Needs review label to the inbox:

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

export default automation("Return Gmail messages to the inbox", () => {
  const messages = gmail.searchMessages({
    limit: 100,
    query: 'label:"Needs review" -in:inbox',
  })

  branch(
    messages.length.transform((length) => length > 0),
    () => {
      gmail.moveMessagesToInbox({
        messageIds: messages.transform((results) =>
          results.map((message) => message.messageId),
        ),
      })
    },
  )
})

Inputs

Name	Type	Required	Description
`messageIds`	`string \| string[]`	Yes	One or up to 1,000 immutable Gmail message IDs.
Second argument: `{ account }`	`string \| Google account reference`	No	Google Account binding. Defaults to the project binding.

Inputs accept compatible signals.

Output

Returns a Signal<string[]> with the modified message IDs in input order. This action only adds INBOX. It doesn’t explicitly remove SPAM or restore a message from Trash. Use gmail.markMessagesAsNotSpam for Spam and gmail.untrashMessages for Trash. Other labels remain applied.