> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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. 
```

<Note>
  External Documentation

  To learn more, visit the [Microsoft Outlook documentation](https://learn.microsoft.com/en-us/graph/api/message-move?view=graph-rest-1.0\&tabs=http).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter                      | Description                                                                                                                            |
  | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
  | Destination ID                 | The destination folder ID, or a well-known folder name. For a list of supported well-known folder names, see mailFolder resource type. |
  | Message ID                     | The unique identifier of the required message.                                                                                         |
  | User ID or User Principal Name | The ID or userPrincipalName of the user.                                                                                               |
</div>

## Example Output

```json theme={"dark"}
{
	"@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](https://library.blinkops.com/workflows/move-message-with-microsoft-outlook-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/move-message-with-microsoft-outlook-and-send-results-via-email/canvas" />
</div>
