Skip to main content

Create Mail Folder

Create a new mail folder in the root folder of the user's mailbox. If you intend a new folder to be hidden, you must set the isHidden property to true on creation.

  • Least privileged Microsoft Graph permission to access the action via application: Mail.ReadWrite.
Note: Using the delegated (OAuth) connection type will only allow to insert the connected user's ID. 
External Documentation

To learn more, visit the Microsoft Outlook documentation.

Basic Parameters

ParameterDescription
Display NameThe display name of the new folder.
User ID or User Principal NameThe ID or userPrincipalName of the user.

Advanced Parameters

ParameterDescription
Is HiddenIndicates whether the new folder is hidden. Setting the property is optional. Once set, you cannot update this property. See more information in Hidden mail folders.

Example Output

{
"displayName": "Clutter",
"parentFolderId": "AQMkADlmOGQwZmU3LWVjOWMtNDhiYgAtODcxNy1",
"childFolderCount": 99,
"unreadItemCount": 99,
"totalItemCount": 99,
"id": "hN2Y5OGRhNGYwODEALgAAA0DAKbvJvFhJgcT3lZpkhNQBAA1",
"isHidden": true
}

Workflow Library Example

Create Mail Folder with Microsoft Outlook and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop