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