Move message

moveMessage relocates a message and returns the message record created in the destination folder.

automations/archive-outlook-message.automation.ts

import { automation } from "automate.ax"
import { moveMessage } from "automate.ax/outlook"

export default automation("Archive Outlook message", () => {
  moveMessage({ messageId: "AAMkAGI2...", destinationFolder: "Archive/2026" })
})

messageId and destinationFolder are required. The destination accepts an exact display path, folder ID, or well-known name. Optional account selects the Microsoft binding. Returns the relocated OutlookMessage. Moving can change the provider message ID. Use the returned messageId for later actions rather than retaining only the source ID. Ambiguous folder names fail; a path or ID resolves the ambiguity.

⌘I

Get started

Concepts

Reference