manage-rules
Destructive
Create, list, update, reorder, or delete inbox rules with conditions, actions, and optional exceptions to automate email handling.
Instructions
Manage inbox rules. action=list (default) lists rules. action=create creates a new rule with conditions, actions, and optional exceptions. action=update modifies an existing rule. action=reorder changes rule execution priority. action=delete removes a rule.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | No | Action to perform (default: list) | |
| includeDetails | No | Include detailed conditions, actions, and exceptions (action=list) | |
| name | No | Rule name (action=create required, action=update to rename) | |
| displayName | No | Alias for `name` (matches Graph's own `displayName` field). | |
| dryRun | No | Preview rule without creating/updating (action=create, action=update) | |
| isEnabled | No | Enable/disable rule (action=create default: true, action=update) | |
| sequence | No | Execution order, lower = higher priority (action=create default: auto, action=reorder required) | |
| fromAddresses | No | Comma-separated sender emails to match (action=create/update) | |
| containsSubject | No | Comma-separated subject keywords (OR logic). e.g. "invoice, receipt, payment" (action=create/update) | |
| bodyContains | No | Comma-separated body text keywords (OR logic) (action=create/update) | |
| bodyOrSubjectContains | No | Comma-separated keywords matching body OR subject (OR logic) (action=create/update) | |
| senderContains | No | Comma-separated partial sender matches (action=create/update) | |
| recipientContains | No | Comma-separated partial recipient matches (action=create/update) | |
| sentToAddresses | No | Comma-separated recipient emails to match (action=create/update) | |
| hasAttachments | No | Match emails with attachments (action=create/update) | |
| importance | No | Match emails with this importance (action=create/update) | |
| sensitivity | No | Match emails with this sensitivity (action=create/update) | |
| sentToMe | No | Match emails sent to me (action=create/update) | |
| sentOnlyToMe | No | Match emails where I am the only recipient (action=create/update) | |
| sentCcMe | No | Match emails where I am in CC (action=create/update) | |
| isAutomaticReply | No | Match automatic reply emails (action=create/update) | |
| moveToFolder | No | Folder name to move matching emails to (action=create/update) | |
| copyToFolder | No | Folder name to copy matching emails to (action=create/update) | |
| markAsRead | No | Mark matching emails as read (action=create/update) | |
| markImportance | No | Set importance on matching emails (action=create/update) | |
| forwardTo | No | Comma-separated emails to forward matching messages to (action=create/update) | |
| redirectTo | No | Comma-separated emails to redirect matching messages to (action=create/update) | |
| assignCategories | No | Comma-separated Outlook categories to assign (action=create/update) | |
| stopProcessingRules | No | Stop evaluating subsequent rules (action=create/update) | |
| deleteMessage | No | Move matching emails to Deleted Items (action=create/update) | |
| exceptFromAddresses | No | Comma-separated sender emails to exclude (action=create/update) | |
| exceptSubjectContains | No | Comma-separated subject keywords to exclude (action=create/update) | |
| exceptSenderContains | No | Comma-separated partial sender matches to exclude (action=create/update) | |
| exceptBodyContains | No | Comma-separated body keywords to exclude (action=create/update) | |
| exceptHasAttachments | No | Exclude emails with attachments (action=create/update) | |
| ruleName | No | Name of existing rule (action=update/reorder/delete) | |
| ruleId | No | ID of existing rule (action=update/delete) |