Skip to main content

Move Message

Move a message to another folder within the specified user's mailbox. This creates a new copy of the message in the destination folder and removes the original message.

  • Least privileged Microsoft Graph permission to access the action via application: Mail.ReadWrite.
Note: Using the delegated (OAuth) connection type will only allow to insert the connected user's ID.
External Documentation

To learn more, visit the Microsoft Outlook documentation.

Parameters​

ParameterDescription
Destination IDThe destination folder ID, or a well-known folder name. For a list of supported well-known folder names, see mailFolder resource type.
Message ID-
User ID or User Principal NameThe ID or userPrincipalName of the user.

Example Output​

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#message",
    "@odata.type": "#microsoft.graph.message",
    "@odata.etag": "W/\"FwAAABYAAAC4ofQHEIqCSbQPot83AFcbAAAW/0tB\"",
    "id": "AAMkADhAAAW-VPeAAA=",
    "createdDateTime": "2018-08-12T08:43:22Z",
    "lastModifiedDateTime": "2018-08-15T19:47:54Z",
    "changeKey": "FwAAABYAAAC4ofQHEIqCSbQPot83AFcbAAAW/0tB",
    "categories": [],
    "receivedDateTime": "2018-08-12T08:43:22Z",
    "sentDateTime": "2018-08-12T08:43:20Z",
    "hasAttachments": false,
    "internetMessageId": "<00535324-5988-4b6a-b9af-d44cf2d0b691@MWHPR2201MB1022.namprd22.prod.outlook.com>",
    "subject": "Undeliverable: Meet for lunch?",
    "bodyPreview": "Delivery has failed to these recipients or groups:\r\n\r\nfannyd@contoso.onmicrosoft.com (fannyd@contoso.onmicrosoft.com)\r\nYour message couldn't be delivered. Despite repeated attempts to deliver your message, querying the Domain Name System (DNS) for the rec",
    "importance": "normal",
    "parentFolderId": "AAMkADhAAAAAAEKAAA=",
    "conversationId": "AAQkADhJzfbkARFhe5kKhjihSA=",
    "isDeliveryReceiptRequested": null,
    "isReadReceiptRequested": false,
    "isRead": false,
    "isDraft": false,
    "webLink": "https://outlook.office365.com/owa/?ItemID=AAMkADhAAAW%2FVPeAAA%3D&exvsurl=1&viewmodel=ReadMessageItem",
    "inferenceClassification": "focused",
    "body": {
        "contentType": "html",
        "content": "<html></html>"
    },
    "sender": {
        "emailAddress": {
            "name": "Microsoft Outlook",
            "address": "MicrosoftExchange329e71ec88ae4615bbc36ab6ce41109e@contoso.onmicrosoft.com"
        }
    },
    "from": {
        "emailAddress": {
            "name": "Microsoft Outlook",
            "address": "MicrosoftExchange329e71ec88ae4615bbc36ab6ce41109e@contoso.onmicrosoft.com"
        }
    },
    "toRecipients": [
        {
            "emailAddress": {
                "name": "fannyd@contoso.onmicrosoft.com",
                "address": "fannyd@contoso.onmicrosoft.com"
            }
        },
        {
            "emailAddress": {
                "name": "danas@contoso.onmicrosoft.com",
                "address": "danas@contoso.onmicrosoft.com"
            }
        }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "flag": {
        "flagStatus": "notFlagged"
    }
}

Workflow Library Example​

Move Message with Microsoft Outlook and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop