me.mailFolder

List mailFolders

Get the mail folder collection directly under the root folder of the signed-in user. The returned collection includes any mail search folders directly under the root. By default, this operation does not return hidden folders. Use the includeHiddenFolders query parameter to include them in the response.

get/me/mailFolders

Query parameters

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

Response

Retrieved collection

@odata.nextLinkstring nullable

@odata.countinteger nullable

Changes

Changed in 5 of the 10 revisions of this API.1164

Jul 17, 2026af62694b9f2d1See the full diff
- ○
  added the optional property allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/contentBytes to the response with the 2XX status
  response-optional-property-added
May 27, 2026354d90657cdd1See the full diff
- ○
  api operation id me.ListMailFolders removed and replaced with listMailFolders
  api-operation-id-removed
May 26, 20265c775c50414c30See the full diff
- ○
  mapped value for discriminator key #microsoft.graph.attachment changed from microsoft.graph.attachment to MicrosoftGraphAttachment for allOf[subschema #2]/value/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.attachment changed from microsoft.graph.attachment to MicrosoftGraphAttachment for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.attachment changed from microsoft.graph.attachment to MicrosoftGraphAttachment for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.attachment changed from microsoft.graph.attachment to MicrosoftGraphAttachment for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.eventMessage changed from microsoft.graph.message to MicrosoftGraphMessage for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from microsoft.graph.fileAttachment to MicrosoftGraphAttachment for allOf[subschema #2]/value/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from microsoft.graph.fileAttachment to MicrosoftGraphAttachment for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from microsoft.graph.fileAttachment to MicrosoftGraphAttachment for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from microsoft.graph.fileAttachment to MicrosoftGraphAttachment for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from microsoft.graph.fileAttachment to MicrosoftGraphAttachment for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.itemAttachment changed from microsoft.graph.attachment to MicrosoftGraphAttachment for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailFolder changed from microsoft.graph.mailFolder to MicrosoftGraphMailFolder for allOf[subschema #2]/value/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailFolder changed from microsoft.graph.mailFolder to MicrosoftGraphMailFolder for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailFolder changed from microsoft.graph.mailFolder to MicrosoftGraphMailFolder for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailFolder changed from microsoft.graph.mailFolder to MicrosoftGraphMailFolder for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from microsoft.graph.mailSearchFolder to MicrosoftGraphMailFolder for allOf[subschema #2]/value/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from microsoft.graph.mailSearchFolder to MicrosoftGraphMailFolder for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from microsoft.graph.mailSearchFolder to MicrosoftGraphMailFolder for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from microsoft.graph.mailSearchFolder to MicrosoftGraphMailFolder for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from microsoft.graph.mailSearchFolder to MicrosoftGraphMailFolder for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from microsoft.graph.message to MicrosoftGraphMessage for allOf[subschema #2]/value/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from microsoft.graph.message to MicrosoftGraphMessage for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from microsoft.graph.message to MicrosoftGraphMessage for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #2: outlookItem]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from microsoft.graph.message to MicrosoftGraphMessage for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from microsoft.graph.message to MicrosoftGraphMessage for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.outlookItem changed from microsoft.graph.outlookItem to MicrosoftGraphOutlookItem for allOf[subschema #2]/value/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.outlookItem changed from microsoft.graph.outlookItem to MicrosoftGraphOutlookItem for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.outlookItem changed from microsoft.graph.outlookItem to MicrosoftGraphOutlookItem for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.outlookItem changed from microsoft.graph.outlookItem to MicrosoftGraphOutlookItem for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.referenceAttachment changed from microsoft.graph.attachment to MicrosoftGraphAttachment for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
May 26, 2026179a8793b9381See the full diff
- ▲
  for the query request parameter includeHiddenFolders, the type/format was changed from string/ to boolean/
  request-parameter-type-changed
May 26, 2026c6fc1d98f528132See the full diff
- ●
  removed the optional property allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/contentBytes from the response with the 2XX status
  response-optional-property-removed
- ○
  api operation id listMailFolders removed and replaced with me.ListMailFolders
  api-operation-id-removed
- ○
  for the query request parameter includeHiddenFolders, the type/format was generalized from boolean/ to string/
  request-parameter-type-generalized
- ○
  mapped value for discriminator key #microsoft.graph.attachment changed from MicrosoftGraphAttachment to microsoft.graph.attachment for allOf[subschema #2]/value/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.attachment changed from MicrosoftGraphAttachment to microsoft.graph.attachment for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.attachment changed from MicrosoftGraphAttachment to microsoft.graph.attachment for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.attachment changed from MicrosoftGraphAttachment to microsoft.graph.attachment for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.eventMessage changed from MicrosoftGraphMessage to microsoft.graph.message for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from MicrosoftGraphAttachment to microsoft.graph.fileAttachment for allOf[subschema #2]/value/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from MicrosoftGraphAttachment to microsoft.graph.fileAttachment for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from MicrosoftGraphAttachment to microsoft.graph.fileAttachment for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from MicrosoftGraphAttachment to microsoft.graph.fileAttachment for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.fileAttachment changed from MicrosoftGraphAttachment to microsoft.graph.fileAttachment for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.itemAttachment changed from MicrosoftGraphAttachment to microsoft.graph.attachment for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailFolder changed from MicrosoftGraphMailFolder to microsoft.graph.mailFolder for allOf[subschema #2]/value/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailFolder changed from MicrosoftGraphMailFolder to microsoft.graph.mailFolder for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailFolder changed from MicrosoftGraphMailFolder to microsoft.graph.mailFolder for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailFolder changed from MicrosoftGraphMailFolder to microsoft.graph.mailFolder for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from MicrosoftGraphMailFolder to microsoft.graph.mailSearchFolder for allOf[subschema #2]/value/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from MicrosoftGraphMailFolder to microsoft.graph.mailSearchFolder for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from MicrosoftGraphMailFolder to microsoft.graph.mailSearchFolder for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from MicrosoftGraphMailFolder to microsoft.graph.mailSearchFolder for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.mailSearchFolder changed from MicrosoftGraphMailFolder to microsoft.graph.mailSearchFolder for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from MicrosoftGraphMessage to microsoft.graph.message for allOf[subschema #2]/value/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from MicrosoftGraphMessage to microsoft.graph.message for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from MicrosoftGraphMessage to microsoft.graph.message for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #2: outlookItem]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from MicrosoftGraphMessage to microsoft.graph.message for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.message changed from MicrosoftGraphMessage to microsoft.graph.message for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.outlookItem changed from MicrosoftGraphOutlookItem to microsoft.graph.outlookItem for allOf[subschema #2]/value/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.outlookItem changed from MicrosoftGraphOutlookItem to microsoft.graph.outlookItem for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[MicrosoftGraphOutlookItem]/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.outlookItem changed from MicrosoftGraphOutlookItem to microsoft.graph.outlookItem for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.outlookItem changed from MicrosoftGraphOutlookItem to microsoft.graph.outlookItem for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/extensions/items/allOf[subschema #1: entity]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed
- ○
  mapped value for discriminator key #microsoft.graph.referenceAttachment changed from MicrosoftGraphAttachment to microsoft.graph.attachment for allOf[subschema #2]/value/items/allOf[subschema #2: mailFolder]/messages/items/allOf[subschema #2: message]/attachments/items/allOf[subschema #2: attachment]/ response property for the response status 2XX
  response-property-discriminator-mapping-changed

Full history