# Microsoft Outlook Mail Folders API

**Canonical:** https://apis.io/apis/microsoft-outlook/microsoft-outlook-mail-folders-api/  
**Provider:** Microsoft Outlook — https://apis.io/providers/microsoft-outlook/  
**Base URL:** https://graph.microsoft.com/v1.0  
**Documentation:** https://learn.microsoft.com/en-us/graph/api/resources/mail-api-overview?view=graph-rest-1.0

Microsoft Outlook Mail Folders API is one of 4 APIs that [Microsoft Outlook](https://apis.io/providers/microsoft-outlook/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Mail Folders. 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.

Operations on mail folders in a user mailbox

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| 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 |

## Machine-readable artifacts (25)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/microsoft-outlook/refs/heads/main/openapi/microsoft-outlook-mail-folders-api-openapi.yml
- **Documentation** — https://learn.microsoft.com/en-us/graph/api/resources/mail-api-overview?view=graph-rest-1.0
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/microsoft-outlook/refs/heads/main/json-schema/microsoft-outlook-message-schema.json
- **JSONLD** — https://raw.githubusercontent.com/api-evangelist/microsoft-outlook/refs/heads/main/json-ld/microsoft-outlook-context.jsonld
- **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
- **SDKs** — https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
- **ChangeLog** — https://developer.microsoft.com/en-us/graph/changelog
- **Documentation** — https://learn.microsoft.com/en-us/graph/api/resources/calendar?view=graph-rest-1.0
- **CodeExamples** — https://learn.microsoft.com/en-us/graph/api/resources/calendar?view=graph-rest-1.0#code-samples
- **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

## Other Microsoft Outlook APIs (3)

- [Outlook Add-ins API](https://apis.io/apis/microsoft-outlook/outlook-add-ins-api/)
- [Microsoft Outlook Attachments API](https://apis.io/apis/microsoft-outlook/microsoft-outlook-attachments-api/)
- [Microsoft Outlook Messages API](https://apis.io/apis/microsoft-outlook/microsoft-outlook-messages-api/)

## Tags

Mail Folders

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/microsoft-outlook/microsoft-outlook-mail-folders-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/microsoft-outlook/.