Outlook icon

Outlook

Manage Microsoft Graph Outlook subscriptions, messages, and attachments

Actions25

Message → Move

AI-generated

Summary

Moves a message from the selected mailbox into a destination mail folder. Choose an existing folder, enter its ID, or create a new top-level folder by name before moving the message.

Inputs

  • Mailbox — Select Current Mailbox (default) or Other Mailbox.
  • Other Mailbox Email (required) — Shown when Other Mailbox is selected; enter the mailbox email address.
  • Message ID (required) — ID of the message to move.
  • Use Immutable ID — Defaults to false. Enable when Message ID is an immutable ID; the request uses the Microsoft Graph Prefer header IdType="ImmutableId".
  • Specify Destination Folder As — Choose Select from List (default), Enter Folder ID, or Create New Folder.
  • Destination Folder — Select the existing destination folder from the folder list.
  • Destination Folder ID — Enter the destination folder ID directly.
  • New Folder Name (required) — Name of the new top-level mail folder to create before moving the message into it.

Output shape

a single moved message record

The destination folder input depends on the selected destination mode. The operation uses Microsoft Graph's move action and returns its message response.

Links

Discussion