--- title: "Changes to Create message (draft)" method: POST path: "/me/messages" --- # Changes to Create message (draft) `POST /me/messages` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 4 of 10 revisions. - **2026-07-17** `af62694b9f2d` — 2 info - **2026-05-27** `354d90657cdd` — 1 info - **2026-05-26** `5c775c50414c` — 46 info - **2026-05-26** `c6fc1d98f528` — 2 warning, 47 info ## Changes - **2026-07-17** `af62694b9f2d` — 2 info - added the new optional request property `allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/contentBytes` - added the optional property `allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/contentBytes` to the response with the `2XX` status - **2026-05-27** `354d90657cdd` — 1 info - api operation id `me.CreateMessages` removed and replaced with `createDraftMessage` - **2026-05-26** `5c775c50414c` — 46 info - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/microsoft.graph.attachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/microsoft.graph.attachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/microsoft.graph.attachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.eventMessage` changed from `#/components/schemas/microsoft.graph.message` to `#/components/schemas/MicrosoftGraphMessage` for `allOf[subschema #2: message]/` request property - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/microsoft.graph.fileAttachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/microsoft.graph.fileAttachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/microsoft.graph.fileAttachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` request property - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/microsoft.graph.fileAttachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.itemAttachment` changed from `#/components/schemas/microsoft.graph.attachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` request property - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/microsoft.graph.mailFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/microsoft.graph.mailFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/microsoft.graph.mailFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/microsoft.graph.mailSearchFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/microsoft.graph.mailSearchFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/microsoft.graph.mailSearchFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/microsoft.graph.message` to `#/components/schemas/MicrosoftGraphMessage` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/microsoft.graph.message` to `#/components/schemas/MicrosoftGraphMessage` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #2: outlookItem]/` request property - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/microsoft.graph.message` to `#/components/schemas/MicrosoftGraphMessage` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/microsoft.graph.message` to `#/components/schemas/MicrosoftGraphMessage` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.outlookItem` changed from `#/components/schemas/microsoft.graph.outlookItem` to `#/components/schemas/MicrosoftGraphOutlookItem` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.outlookItem` changed from `#/components/schemas/microsoft.graph.outlookItem` to `#/components/schemas/MicrosoftGraphOutlookItem` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.outlookItem` changed from `#/components/schemas/microsoft.graph.outlookItem` to `#/components/schemas/MicrosoftGraphOutlookItem` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.referenceAttachment` changed from `#/components/schemas/microsoft.graph.attachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` request property - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/microsoft.graph.attachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/microsoft.graph.attachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/microsoft.graph.attachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.eventMessage` changed from `#/components/schemas/microsoft.graph.message` to `#/components/schemas/MicrosoftGraphMessage` for `allOf[subschema #2: message]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/microsoft.graph.fileAttachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/microsoft.graph.fileAttachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/microsoft.graph.fileAttachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/microsoft.graph.fileAttachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.itemAttachment` changed from `#/components/schemas/microsoft.graph.attachment` to `#/components/schemas/MicrosoftGraphAttachment` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/microsoft.graph.mailFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/microsoft.graph.mailFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/microsoft.graph.mailFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/microsoft.graph.mailSearchFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/microsoft.graph.mailSearchFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/microsoft.graph.mailSearchFolder` to `#/components/schemas/MicrosoftGraphMailFolder` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/microsoft.graph.message` to `#/components/schemas/MicrosoftGraphMessage` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/microsoft.graph.message` to `#/components/schemas/MicrosoftGraphMessage` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #2: outlookItem]/` response property for the response status `2XX` - …6 more - **2026-05-26** `c6fc1d98f528` — 2 warning, 47 info - removed the request property `allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/contentBytes` - removed the optional property `allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/contentBytes` from the response with the `2XX` status - api operation id `createDraftMessage` removed and replaced with `me.CreateMessages` - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.eventMessage` changed from `#/components/schemas/MicrosoftGraphMessage` to `#/components/schemas/microsoft.graph.message` for `allOf[subschema #2: message]/` request property - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.fileAttachment` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.fileAttachment` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.fileAttachment` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` request property - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.fileAttachment` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.itemAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` request property - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailFolder` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailFolder` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailFolder` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailSearchFolder` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailSearchFolder` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailSearchFolder` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/MicrosoftGraphMessage` to `#/components/schemas/microsoft.graph.message` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/MicrosoftGraphMessage` to `#/components/schemas/microsoft.graph.message` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #2: outlookItem]/` request property - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/MicrosoftGraphMessage` to `#/components/schemas/microsoft.graph.message` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.message` changed from `#/components/schemas/MicrosoftGraphMessage` to `#/components/schemas/microsoft.graph.message` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.outlookItem` changed from `#/components/schemas/MicrosoftGraphOutlookItem` to `#/components/schemas/microsoft.graph.outlookItem` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.outlookItem` changed from `#/components/schemas/MicrosoftGraphOutlookItem` to `#/components/schemas/microsoft.graph.outlookItem` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.outlookItem` changed from `#/components/schemas/MicrosoftGraphOutlookItem` to `#/components/schemas/microsoft.graph.outlookItem` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` request property - mapped value for discriminator key `#microsoft.graph.referenceAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` request property - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.attachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.eventMessage` changed from `#/components/schemas/MicrosoftGraphMessage` to `#/components/schemas/microsoft.graph.message` for `allOf[subschema #2: message]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.fileAttachment` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.fileAttachment` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.fileAttachment` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.fileAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.fileAttachment` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.itemAttachment` changed from `#/components/schemas/MicrosoftGraphAttachment` to `#/components/schemas/microsoft.graph.attachment` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailFolder` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailFolder` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.mailFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailFolder` for `allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailSearchFolder` for `allOf[#/components/schemas/MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/` response property for the response status `2XX` - mapped value for discriminator key `#microsoft.graph.mailSearchFolder` changed from `#/components/schemas/MicrosoftGraphMailFolder` to `#/components/schemas/microsoft.graph.mailSearchFolder` for `allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/` response property for the response status `2XX` - …9 more --- [Operation](https://skmtc.dev/ballerina-platform/apis/microsoft-graph-mail-api/docs/me/messages/post.md) · [API](https://skmtc.dev/ballerina-platform/apis/microsoft-graph-mail-api.md) · [Page](https://skmtc.dev/ballerina-platform/apis/microsoft-graph-mail-api/changes/me/messages/post)