users.mailFolder

List mailFolders from user

Get the mail folder collection directly under the root folder of a specific user's mailbox.

get/users/{userIdentifier}/mailFolders

Request

Base URL
https://graph.microsoft.com/v1.0
Auth
OAuth 2
Authorization codehttps://login.microsoftonline.com/common/oauth2/v2.0/authorize
Client credentials
Token URLhttps://login.microsoftonline.com/common/oauth2/v2.0/token
ScopesMail.Read, Mail.ReadWrite, Mail.Send
TypeScript
https://skmtc.dev/ballerina-platform/apis/microsoft-graph-mail-api/docs/users/:userIdentifier/mailFolders/get.ts
A function with typed inputs. Its response is checked against the schema.

includeHiddenFoldersboolean

Include Hidden Folders

$topinteger

Show only the first n items

$skipinteger

Skip the first n items

$searchstring

Search items by search phrases

$filterstring

Filter items by property values

$countboolean

Include count of items

$orderbystring[]

Order items by property values

$selectstring[]

Select properties to be returned

$expandstring[]

Expand related entities

Retrieved collection

@odata.nextLinkstring nullable

@odata.countinteger nullable

Jul 17, 2026af62694b9f2d Revision changes
- info
  added the optional property ////////// to the response with the status
Jun 18, 2026990ed583c385 Revision changes
- info
  endpoint added