# Microsoft Graph API - Move mail message action
The Move mail message action moves 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.
# Input
| Input field | Description |
|---|---|
| Destination folder ID or name | The target folder's unique ID or well-known name where the email will be moved. |
| Message ID | The unique identifier of the email message to be moved. |
| User ID or principal name | The unique ID or email address of the mailbox owner. |
| Mail folder ID | The unique ID of the source folder containing the email. |
# Output
| Output field | Description |
|---|---|
| OData ETag | Entity tag for concurrency control. |
| Message ID | Unique identifier for the message. |
| Created DateTime | Date and time when the message was created. |
| Last Modified DateTime | Date and time when the message was last modified. |
| Change Key | Identifies a specific version of the message. |
| Categories | List of categories associated with the message. |
| Received DateTime | Date and time when the message was received. |
| Sent DateTime | Date and time when the message was sent. |
| Has Attachments | Indicates whether the message has attachments (Yes/No). |
| Internet Message ID | Unique identifier for the message in internet format. |
| Subject | Subject of the message. |
| Body Preview | Preview text of the message body. |
| Importance | Importance level of the message. For example, Low, Normal, High. |
| Parent Folder ID | ID of the parent folder containing the message. |
| Conversation ID | ID of the conversation thread. |
| Conversation Index | Position of the message in the conversation thread. |
| Delivery Receipt Requested | Indicates if a delivery receipt was requested (Yes/No). |
| Read Receipt Requested | Indicates if a read receipt was requested (Yes/No). |
| Is Read | Indicates if the message has been read (Yes/No). |
| Is Draft | Indicates if the message is a draft (Yes/No). |
| Web Link | URL to access the message in a web browser. |
| Inference Classification | Classification of the message. For example, Focused, Other. |
| Body Content Type | Type of content in the message body. For example, Text, HTML. |
| Body Content | Actual content of the message body. |
| Sender Name | Name of the sender. |
| Sender Email Address | Email address of the sender. |
| From Name | Name of the person who sent the message. |
| From Email Address | Email address of the sender. |
| To Recipient Name | Name of the recipient. |
| To Recipient Email Address | Email address of the recipient. |
| CC Recipients | List of CC recipients. |
| BCC Recipients | List of BCC recipients. |
| Reply To | List of reply-to email addresses. |
| Flag Status | Status of the message flag. For example, Not Flagged, Complete, Flagged. |
Last updated: 5/21/2025, 5:22:32 AM