users.message

Copy message from user

Changed on Jul 17, 2026

Copy a message to a folder within a specific user's mailbox.

post/users/{userIdentifier}/messages/{messageId}/copy

Request

Base URL
https://graph.microsoft.com/v1.0
Auth
OAuth 2
Authorization codehttps://login.microsoftonline.com/common/oauth2/v2.0/authorize
Client credentials
Token URLhttps://login.microsoftonline.com/common/oauth2/v2.0/token
ScopesMail.Read, Mail.ReadWrite, Mail.Send
TypeScript
https://skmtc.dev/ballerina-platform/apis/microsoft-graph-mail-api/docs/users/:userIdentifier/messages/:messageId/copy/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

DestinationIdstring

The destination folder ID or well-known folder name

Response

If successful, returns the copied message in the destination folder of the specified user's mailbox. Unless, the destination folder may not exist or the message may not be found.

CompletedResponse nullable required

Changes

Jul 17, 2026af62694b9f2d Revision changes
- info
  added the optional property //////// to the response with the status
Jun 18, 2026a28c33d2e65c Revision changes
- info
  removed subschema #2: message from the response body allOf list for the response status
- info
  added to the response body anyOf list for the response status

Operation history (4 revisions)

Copy message from user

Request

Request body

Response 2XX

Changes

Response