Skip to main content

List Messages Rules

Get all the message rule objects defined for the user's inbox.

  • Least privileged Microsoft Graph permission to access the action via application: MailboxSettings.Read.
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.

Parameters

ParameterDescription
User ID or User Principal NameThe ID or userPrincipalName of the user.

If connected via OAuth, only the connected user's ID is supported. With App Registration, any user ID can be used.

Example Output

{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Me/mailFolders('inbox')/messageRules",
"value": [
{
"id": "AQAAAJ5dZp8=",
"displayName": "Remove spam",
"sequence": 1,
"isEnabled": true,
"hasError": false,
"isReadOnly": false,
"conditions": {
"subjectContains": [
"enter to win"
]
},
"actions": {
"delete": true,
"stopProcessingRules": true
}
},
{
"id": "AQAAAJ5dZqA=",
"displayName": "From partner",
"sequence": 2,
"isEnabled": true,
"hasError": false,
"isReadOnly": false,
"conditions": {
"senderContains": [
"ADELE"
]
},
"actions": {
"stopProcessingRules": true,
"forwardTo": [
{
"emailAddress": {
"name": "Alex Wilbur",
"address": "AlexW@contoso.onmicrosoft.com"
}
}
]
}
}
]
}

Workflow Library Example

List Messages Rules with Microsoft Outlook and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop