How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Microsoft Outlook Messages API

Operations on email messages in a user mailbox

Microsoft Outlook Messages API is one of 4 APIs that Microsoft Outlook publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Message. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, authentication docs, a getting-started guide, an API reference, and 1 JSON Schema.

This API exposes 17 operations across 13 paths, and defines 10 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://graph.microsoft.com/v1.0.

17 operations 13 paths 10 schemas 1 DELETE3 GET1 PATCH12 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://graph.microsoft.com/v1.0
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Microsoft Outlook Messages API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth2) using the authorizationCode flow, exposing 6 scopes. By default, every request must be authenticated.

  • oauth2 — Microsoft identity platform OAuth 2.0 authorization. Supports delegated (user) and application permissions.

Paths & Operations 17

Across 13 paths, the API surfaces 17 operations — 1 DELETE, 3 GET, 1 PATCH, 12 POST. Each is listed below with its method, path, parameters, and response codes.

Messages 17

Operations on email messages in a user mailbox

GET
/me/messages
Microsoft Outlook List Messages
listMessages 7 params → 200401403429500
POST
/me/messages
Microsoft Outlook Create Draft Message
createDraftMessage body → 201400401403429
GET
/me/messages/{message-id}
Microsoft Outlook Get Message
getMessage 2 params → 200401404429
PATCH
/me/messages/{message-id}
Microsoft Outlook Update Message
updateMessage 1 param body → 200400401404429
DELETE
/me/messages/{message-id}
Microsoft Outlook Delete Message
deleteMessage 1 param → 204401404429
POST
/me/messages/{message-id}/send
Microsoft Outlook Send Draft Message
sendDraftMessage 1 param → 202401404429
POST
/me/messages/{message-id}/copy
Microsoft Outlook Copy Message
copyMessage 1 param body → 201401404429
POST
/me/messages/{message-id}/move
Microsoft Outlook Move Message
moveMessage 1 param body → 201401404429
POST
/me/messages/{message-id}/reply
Microsoft Outlook Reply to Message
replyToMessage 1 param body → 202401404429
POST
/me/messages/{message-id}/replyAll
Microsoft Outlook Reply All to Message
replyAllToMessage 1 param body → 202401404429
POST
/me/messages/{message-id}/forward
Microsoft Outlook Forward Message
forwardMessage 1 param body → 202401404429
POST
/me/messages/{message-id}/createForward
Microsoft Outlook Create Draft to Forward Message
createForwardDraft 1 param body → 201401404
POST
/me/messages/{message-id}/createReply
Microsoft Outlook Create Draft to Reply
createReplyDraft 1 param body → 201401404
POST
/me/messages/{message-id}/createReplyAll
Microsoft Outlook Create Draft to Reply All
createReplyAllDraft 1 param body → 201401404
POST
/me/sendMail
Microsoft Outlook Send Mail
sendMail body → 202400401429
GET
/me/mailFolders/{mailFolder-id}/messages
Microsoft Outlook List Messages in Folder
listMessagesInFolder 6 params → 200401404429
POST
/me/mailFolders/{mailFolder-id}/messages
Microsoft Outlook Create Message in Folder
createMessageInFolder 1 param body → 201400401404429

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are Message (32 properties), Attachment (10 properties), MessageCollectionResponse (4 properties), FollowupFlag (4 properties). Each schema is shown below with its type and property counts.

Recipient
object
Represents information about a user or contact in a message.
1 property
MessageCollectionResponse
object
Collection of message resources with optional pagination link.
4 properties
Message
object
A message in a mailFolder.
32 properties
InternetMessageHeader
object
A key-value pair representing an Internet message header as defined by RFC 5322.
2 properties
FollowupFlag
object
Represents the follow-up flag status on a message.
4 properties
ODataError
object
OData error response from Microsoft Graph.
1 property
Attachment
object
Base resource for file, item, and reference attachments. Use the @odata.type property to specify the derived type.
10 properties
ItemBody
object
Represents the body content of a message.
2 properties
DateTimeTimeZone
object
A date-time value with a time zone designation.
2 properties
EmailAddress
object
Represents an email address entity.
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

microsoft-outlook-messages-api-openapi.yml Raw ↑

Other APIs Microsoft Outlook publishes across the network.

Outlook Add-ins API
Microsoft Outlook Attachments API
Microsoft Outlook Mail Folders API
Where this information came from

This is an independent, third-party profile of Microsoft Outlook Messages API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.