Skip to main content

Understand folder and priority tool permissions

In Complexity, select your mailbox and enable the specific folder or priority tool. It also needs a current MailGen license and separate group grant. Catalog permission names alone do not create executable tools.

Tools implement folder creation/update and priority management. The current tool assembly also exposes ordering, rule editing, sorting-mode changes, and protected deletion proposals where authorized.

AreaRead permissionRead prerequisitesWrite permissionWrite prerequisites
Folder definitionmail.readNo additional permission in this rowmail.folders.create, mail.folders.update, mail.folders.deletemail.folders.manage
Folder ordermail.folders.order.readmail.readmail.folders.order.editmail.folders.order.read and mail.folders.manage
Folder sorting rulemail.folders.sortRules.readmail.rules.readmail.folders.sortRules.editmail.folders.sortRules.read and mail.rules.manage
Folder sorting modemail.sorting.readmail.readmail.folders.sortingMode.togglemail.sorting.manage
Priority definitionmail.priorities.readmail.readmail.priorities.create, mail.priorities.update, mail.priorities.deletemail.priorities.manage
Priority rankmail.priorities.order.readmail.priorities.readmail.priorities.order.editmail.priorities.order.read and mail.priorities.manage
Priority assignment rulemail.priorities.sortRules.readmail.priorities.readmail.priorities.sortRules.editmail.priorities.sortRules.read and mail.priorities.manage
Priority assignment statemail.priorities.readmail.readmail.priorities.sortingMode.togglemail.priorities.manage

These are separate required permissions, not automatic grants. Prerequisite chains also apply. For example, mail.priorities.manage requires mail.priorities.read. Read-only access does not require management authority.

Approval of deleteFolder or deletePriority requires the run to use an active, owned, verified Microsoft mailbox binding. See Microsoft Graph setup. This restriction applies to those deletion approvals, not to all folder or priority tools. Deletion requires separate user approval. Folder commands retain canonical mailbox ordering through Kafka. An accepted command does not prove a remote provider change.

Use folder detail reading for metadata. Use sorting run tools to execute sorting. Editing a rule and running sorting remain separate operations.