users.mailFolder

Get child folder from user

Retrieve the properties and relationships of a child mailFolder in a specific user's mailbox.

get/users/{userIdentifier}/mailFolders/{mailFolderId}/childFolders/{mailFolderId1}

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/:mailFolderId/childFolders/:mailFolderId1/get.ts
A function with typed inputs. Its response is checked against the schema.

includeHiddenFoldersboolean

Include Hidden Folders

$selectstring[]

Select properties to be returned

$expandstring[]

Expand related entities

Retrieved child mail folder

@odata.typestring

idstring

The unique identifier for an entity. Read-only

childFolderCountnumber nullable

The number of immediate child mailFolders in the current mailFolder

parentFolderIdstring nullable

The unique identifier for the mailFolder's parent mailFolder

displayNamestring nullable

The mailFolder's display name

childFoldersMicrosoftGraphMailFolder[] circular

unreadItemCountnumber nullable

The number of items in the mailFolder marked as unread

isHiddenboolean nullable

Indicates whether the mailFolder is hidden. This property can be set only when creating the folder

totalItemCountnumber nullable

The number of items in the mailFolder

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