v1

latestOpenAPI 3.0.42026-07-174835104.5 KB
me.mailFolder

Create child folder

Use this API to create a new child mailFolder. If you intend a new folder to be hidden, you must set the isHidden property to true on creation. To create a mail search folder as a child, set the '@odata.type' property to '#microsoft.graph.mailSearchFolder'.

post/me/mailFolders/{mailFolderId}/childFolders

Request body

@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

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

Response

Created 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

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