# Microsoft 365 Users.mail Folder API

**Canonical:** https://apis.io/apis/microsoft-365/microsoft-365-users-mailfolder-api/  
**Provider:** Microsoft 365 — https://apis.io/providers/microsoft-365/  
**Base URL:** https://graph.microsoft.com/v1.0/  
**Documentation:** https://learn.microsoft.com/en-us/graph/overview

Microsoft 365 Users.mail Folder API is one of 103 APIs that [Microsoft 365](https://apis.io/providers/microsoft-365/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. The published artifact set on APIs.io includes an OpenAPI specification.

The users.mailFolder API from Microsoft 365 — 64 operation(s) for users.mailfolder.

## Operations (60 of 96)

| Method | Path | Summary |
|---|---|---|
| GET | `/users/{user-id}/mailFolders` | Get mailFolders from users |
| POST | `/users/{user-id}/mailFolders` | Create new navigation property to mailFolders for users |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}` | Get mailFolders from users |
| PATCH | `/users/{user-id}/mailFolders/{mailFolder-id}` | Update the navigation property mailFolders in users |
| DELETE | `/users/{user-id}/mailFolders/{mailFolder-id}` | Delete navigation property mailFolders for users |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders` | Get childFolders from users |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders` | Create new navigation property to childFolders for users |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}` | Get childFolders from users |
| PATCH | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}` | Update the navigation property childFolders in users |
| DELETE | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}` | Delete navigation property childFolders for users |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messageRules` | Get messageRules from users |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messageRules` | Create new navigation property to messageRules for users |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messageRules/{messageRule-id}` | Get messageRules from users |
| PATCH | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messageRules/{messageRule-id}` | Update the navigation property messageRules in users |
| DELETE | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messageRules/{messageRule-id}` | Delete navigation property messageRules for users |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messageRules/$count` | Get the number of the resource |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages` | Get messages from users |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages` | Create new navigation property to messages for users |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}` | Get messages from users |
| PATCH | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}` | Update the navigation property messages in users |
| DELETE | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}` | Delete navigation property messages for users |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/$value` | Get media content for the navigation property messages from users |
| PUT | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/$value` | Update media content for the navigation property messages in users |
| DELETE | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/$value` | Delete media content for the navigation property messages in users |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/attachments` | Get attachments from users |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/attachments` | Create new navigation property to attachments for users |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/attachments/{attachment-id}` | Get attachments from users |
| DELETE | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/attachments/{attachment-id}` | Delete navigation property attachments for users |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/attachments/$count` | Get the number of the resource |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/attachments/microsoft.graph.createUploadSession` | Invoke action createUploadSession |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/extensions` | Get extensions from users |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/extensions` | Create new navigation property to extensions for users |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/extensions/{extension-id}` | Get extensions from users |
| PATCH | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/extensions/{extension-id}` | Update the navigation property extensions in users |
| DELETE | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/extensions/{extension-id}` | Delete navigation property extensions for users |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/extensions/$count` | Get the number of the resource |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.copy` | Invoke action copy |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.createForward` | Invoke action createForward |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.createReply` | Invoke action createReply |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.createReplyAll` | Invoke action createReplyAll |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.forward` | Invoke action forward |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.move` | Invoke action move |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.permanentDelete` | Invoke action permanentDelete |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.reply` | Invoke action reply |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.replyAll` | Invoke action replyAll |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.send` | Invoke action send |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/$count` | Get the number of the resource |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/microsoft.graph.delta()` | Invoke function delta |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/microsoft.graph.copy` | Invoke action copy |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/microsoft.graph.move` | Invoke action move |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/microsoft.graph.permanentDelete` | Invoke action permanentDelete |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/$count` | Get the number of the resource |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/microsoft.graph.delta()` | Invoke function delta |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/messageRules` | Get messageRules from users |
| POST | `/users/{user-id}/mailFolders/{mailFolder-id}/messageRules` | Create new navigation property to messageRules for users |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/messageRules/{messageRule-id}` | Get messageRules from users |
| PATCH | `/users/{user-id}/mailFolders/{mailFolder-id}/messageRules/{messageRule-id}` | Update the navigation property messageRules in users |
| DELETE | `/users/{user-id}/mailFolders/{mailFolder-id}/messageRules/{messageRule-id}` | Delete navigation property messageRules for users |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/messageRules/$count` | Get the number of the resource |
| GET | `/users/{user-id}/mailFolders/{mailFolder-id}/messages` | Get messages from users |

…and 36 more operations. They are listed in full on the page.

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/microsoft-365/openapi/microsoft-365-users-mailfolder-api-openapi.yml

## Other Microsoft 365 APIs (12)

- [Microsoft Graph API](https://apis.io/apis/microsoft-365/graph-api/)
- [Microsoft Graph Beta API](https://apis.io/apis/microsoft-365/graph-beta-api/)
- [Microsoft 365 Calendar API](https://apis.io/apis/microsoft-365/microsoft-365-calendar-api/)
- [Microsoft 365 Files API](https://apis.io/apis/microsoft-365/microsoft-365-files-api/)
- [Microsoft 365 Groups API](https://apis.io/apis/microsoft-365/microsoft-365-groups-api/)
- [Microsoft 365 Mail API](https://apis.io/apis/microsoft-365/microsoft-365-mail-api/)
- [Microsoft 365 Me API](https://apis.io/apis/microsoft-365/microsoft-365-me-api/)
- [Microsoft 365 Teams API](https://apis.io/apis/microsoft-365/microsoft-365-teams-api/)
- [Microsoft 365 Users API](https://apis.io/apis/microsoft-365/microsoft-365-users-api/)
- [Microsoft MCP Server for Enterprise](https://apis.io/apis/microsoft-365/mcp-server-enterprise/)
- [Microsoft 365 App Catalogs.teams App API](https://apis.io/apis/microsoft-365/microsoft-365-appcatalogs-teamsapp-api/)
- [Microsoft 365 Chats.chat.Actions API](https://apis.io/apis/microsoft-365/microsoft-365-chats-chat-actions-api/)

---

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