Microsoft Outlook Messages API

Operations on email messages in a user mailbox

Operations 17

GET /me/messages Microsoft Outlook List Messages #
POST /me/messages Microsoft Outlook Create Draft Message #
GET /me/messages/{message-id} Microsoft Outlook Get Message #
PATCH /me/messages/{message-id} Microsoft Outlook Update Message #
DELETE /me/messages/{message-id} Microsoft Outlook Delete Message #
POST /me/messages/{message-id}/send Microsoft Outlook Send Draft Message #
POST /me/messages/{message-id}/copy Microsoft Outlook Copy Message #
POST /me/messages/{message-id}/move Microsoft Outlook Move Message #
POST /me/messages/{message-id}/reply Microsoft Outlook Reply to Message #
POST /me/messages/{message-id}/replyAll Microsoft Outlook Reply All to Message #
POST /me/messages/{message-id}/forward Microsoft Outlook Forward Message #
POST /me/messages/{message-id}/createForward Microsoft Outlook Create Draft to Forward Message #
POST /me/messages/{message-id}/createReply Microsoft Outlook Create Draft to Reply #
POST /me/messages/{message-id}/createReplyAll Microsoft Outlook Create Draft to Reply All #
POST /me/sendMail Microsoft Outlook Send Mail #
GET /me/mailFolders/{mailFolder-id}/messages Microsoft Outlook List Messages in Folder #
POST /me/mailFolders/{mailFolder-id}/messages Microsoft Outlook Create Message in Folder #

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/mail-api-overview?view=graph-rest-1.0
📖
Authentication
https://learn.microsoft.com/en-us/graph/auth/
📖
GettingStarted
https://learn.microsoft.com/en-us/graph/outlook-mail-concept-overview
📖
APIReference
https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/calendar?view=graph-rest-1.0
📖
GettingStarted
https://learn.microsoft.com/en-us/graph/outlook-calendar-concept-overview
📖
APIReference
https://learn.microsoft.com/en-us/graph/api/resources/calendar-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/contact?view=graph-rest-1.0
📖
GettingStarted
https://learn.microsoft.com/en-us/graph/outlook-contacts-concept-overview
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/todo-overview?view=graph-rest-1.0
📖
GettingStarted
https://learn.microsoft.com/en-us/graph/todo-concept-overview
📖
Documentation
https://learn.microsoft.com/en-us/graph/people-insights-overview
📖
Documentation
https://learn.microsoft.com/en-us/graph/outlook-change-notifications-overview
📖
GettingStarted
https://learn.microsoft.com/en-us/graph/change-notifications-delivery-webhooks
📖
APIReference
https://learn.microsoft.com/en-us/graph/api/resources/change-notifications-api-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/manage-focused-inbox?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/messagerule?view=graph-rest-1.0
📖
GettingStarted
https://learn.microsoft.com/en-us/graph/outlook-organize-messages
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/outlookcategory?view=graph-rest-1.0

Specifications

Code Examples

Schemas & Data

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/microsoft-outlook-messages-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

microsoft-outlook-messages-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Microsoft Outlook Microsoft Graph Mail Messages API
  description: API for accessing Outlook email messages, mail folders, and attachments through Microsoft Graph. Provides full CRUD operations on messages, mail folder management, attachment handling, and message actions such as send, reply, forward, copy, and move.
  version: 1.0.0
  contact:
    name: Microsoft Graph Support
    url: https://developer.microsoft.com/en-us/graph/support
  license:
    name: Microsoft API Terms of Use
    url: https://learn.microsoft.com/en-us/legal/microsoft-apis/terms-of-use
  x-api-id: microsoft-graph-mail
  x-audience: external
servers:
- url: https://graph.microsoft.com/v1.0
  description: Microsoft Graph v1.0 production endpoint
security:
- oauth2: []
tags:


# --- truncated at 32 KB (78 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-outlook/refs/heads/main/openapi/microsoft-outlook-messages-api-openapi.yml