List New Messages

Lists all messages in user’s mailbox. The value me can not be used in the User ID parameter.

• 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 Documentation

To learn more, visit the Microsoft Outlook documentation.

Parameters

Parameter	Description
Filter	Specify an OData $filter query option to refine the retrieved messages. Example: from/emailAddress/address eq '[e-mail]' Note: To filter by time, please only use the From Date parameter.
From Date	Date from which to show all new messages.
Limit	Set the page size of the returned results.
Order By	Order the results by one or more properties and their correlating directions. Example: receivedDateTime desc
Return All Pages	Automatically fetch all resources, page by page.
User ID or User Principal Name	The ID or userPrincipalName of the user.

Example Output

{
	"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('bb8775a4-4d8c-42cf-a1d4-4d58c2bb668f')/messages(sender,subject)",
	"value": [
		{
			"@odata.etag": "W/\"CQAAABYAAADHcgC8Hl9tRZ/hc1wEUs1TAAAwR4Hg\"",
			"id": "AAMkAGUAAAwTW09AAA=",
			"subject": "You have late tasks!",
			"sender": {
				"emailAddress": {
					"name": "Microsoft Planner",
					"address": "[e-mail]"
				}
			}
		}
	],
	"@odata.nextLink": "<string>"
}

Workflow Library Example

List New Messages with Microsoft Outlook and Send Results Via Email

Preview this Workflow on desktop