Skip to main content
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 DocumentationTo 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