skills/create-message/SKILL.md
# Create Draft Message Creates a new draft message in the signed-in user's mailbox. The draft can be updated and sent later using the send draft operation. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: POST - **Path**: `/me/messages` - **Operation ID**: `createMessage` - **Tag**: Messages - **OpenAPI**: [microsoft-outlook-mail-api.yaml](../../openapi/microsoft-outlook-mail-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0
npx skillsauth add naftiko/microsoft-outlook-sandbox skills/create-messageInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Creates a new draft message in the signed-in user's mailbox. The draft can be updated and sent later using the send draft operation.
/me/messagescreateMessageMock server URL: http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/messages
Authorization: Bearer {access-token}Content-Type: application/jsonMail.ReadWrite| Property | Type | Description |
|----------|------|-------------|
| subject | string | The subject of the message |
| body | object | The body of the message with contentType (text/html) and content |
| toRecipients | array | Array of recipient objects with emailAddress containing name and address |
| ccRecipients | array | Array of CC recipient objects |
| bccRecipients | array | Array of BCC recipient objects |
| importance | string | The importance of the message: low, normal, high |
curl -X POST "http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/messages" \
-H "Authorization: Bearer {access-token}" \
-H "Content-Type: application/json" \
-d '{
"subject": "Quarterly Review Meeting",
"body": {
"contentType": "html",
"content": "<html><body>Please join us for the quarterly review...</body></html>"
},
"toRecipients": [
{
"emailAddress": {
"name": "Megan Bowen",
"address": "[email protected]"
}
}
],
"importance": "normal"
}'
{
"id": "AAMkAGI1AAAGB1rUAAA=",
"subject": "Quarterly Review Meeting",
"bodyPreview": "Please join us for the quarterly review...",
"body": {"contentType": "html", "content": "<html><body>Please join us for the quarterly review...</body></html>"},
"importance": "normal",
"isRead": false,
"isDraft": true,
"hasAttachments": false,
"from": {"emailAddress": {"name": "Alex Wilber", "address": "[email protected]"}},
"toRecipients": [{"emailAddress": {"name": "Megan Bowen", "address": "[email protected]"}}],
"createdDateTime": "2024-01-15T10:30:00Z",
"receivedDateTime": "2024-01-15T10:30:00Z",
"parentFolderId": "AAMkAGI1AAAEJAAA="
}
Use this operation to create a draft message that can be edited before sending. After creating the draft, you can add attachments using the create attachment operation and then send it using the send draft message operation. The response returns the created message with isDraft set to true and a status code of 201. This is the preferred workflow when you need to compose a message in multiple steps.
tools
# Update Open Extension Update an existing open type extension on a message. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: PATCH - **Path**: `/me/messages/{message-id}/extensions/{extension-id}` - **Operation ID**: `updateOpenExtension` - **Tag**: Extensions - **OpenAPI**: [microsoft-outlook-mail-api.yaml](../../openapi/microsoft-outlook-mail-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/messages/{message-id}/exten
development
# Update Message Updates the properties of an existing message in the signed-in user's mailbox, such as marking it as read or changing its importance. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: PATCH - **Path**: `/me/messages/{message-id}` - **Operation ID**: `updateMessage` - **Tag**: Messages - **OpenAPI**: [microsoft-outlook-mail-api.yaml](../../openapi/microsoft-outlook-mail-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-outlook-mail-
development
# Update Inbox Rule Update the properties of an existing inbox message rule. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: PATCH - **Path**: `/me/mailFolders/inbox/messageRules/{messageRule-id}` - **Operation ID**: `updateMessageRule` - **Tag**: InboxRules - **OpenAPI**: [microsoft-outlook-mail-api.yaml](../../openapi/microsoft-outlook-mail-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/mailFolders/inbox/messageRule
development
# Update Mailbox Settings Update the user's mailbox settings such as automatic replies, locale, time zone, or working hours. ## API Details - **API**: Microsoft Outlook Mail API - **Method**: PATCH - **Path**: `/me/mailboxSettings` - **Operation ID**: `updateMailboxSettings` - **Tag**: MailboxSettings - **OpenAPI**: [microsoft-outlook-mail-api.yaml](../../openapi/microsoft-outlook-mail-api.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/mail