Microsoft Outlook Mail Folders API

Operations on mail folders in a user mailbox

Operations 11

GET /me/mailFolders Microsoft Outlook List Mail Folders #
POST /me/mailFolders Microsoft Outlook Create Mail Folder #
GET /me/mailFolders/{mailFolder-id} Microsoft Outlook Get Mail Folder #
PATCH /me/mailFolders/{mailFolder-id} Microsoft Outlook Update Mail Folder #
DELETE /me/mailFolders/{mailFolder-id} Microsoft Outlook Delete Mail Folder #
GET /me/mailFolders/{mailFolder-id}/childFolders Microsoft Outlook List Child Folders #
POST /me/mailFolders/{mailFolder-id}/childFolders Microsoft Outlook Create Child Folder #
GET /me/mailFolders/{mailFolder-id}/messages Microsoft Outlook List Messages in Folder #
POST /me/mailFolders/{mailFolder-id}/messages Microsoft Outlook Create Message in Folder #
POST /me/mailFolders/{mailFolder-id}/copy Microsoft Outlook Copy Mail Folder #
POST /me/mailFolders/{mailFolder-id}/move Microsoft Outlook Move Mail 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-mail-folders-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-mail-folders-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Microsoft Outlook Microsoft Graph Mail Mail Folders 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 (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-outlook/refs/heads/main/openapi/microsoft-outlook-mail-folders-api-openapi.yml