Get Outlook Emails

Retrieves emails from Outlook based on specified filters such as date, sender, and read/unread status.

This procedure is part of the Microsoft Outlook Book (BDK). To use this book, you must first learn it in your agent.

Note: This operation requires the following permissions on the scopes: Mail.Read, Mail.ReadWrite, Mail.ReadBasic, Mail.ReadBasic.All, Mail.ReadWrite.Shared

Input Concepts

Concept	Description	Type	Required
email folder	The email folder from where the emails will be retrieved	outlook email folder	Yes

Output Concepts

Concept	Description	Type
email folder's emails	All the emails for the email folder	outlook email

Examples

Retrieve all emails for the specified email folder

use the above as the email folder
get some email folder's emails

Retrieve all emails for the specified email folder whose subject matches the specified one

use the above as the email folder
get some email folder's emails whose subject is "Email with attachment"

Retrieve all emails for the specified email folder whose received date is after Feb 25, 2024 12:30 UTC

use the above as the email folder
the date is "2024-02-25T12:30:00Z"
get the date as a datetime
use the above as the target
get some email folder's emails whose "receivedDateTime" is greater than the target

Retrieve all emails for the specified email folder whose sender matches the specified one

use the above as the email folder
get some email folder's emails whose "from/emailAddress/address" is "[e-mail]"

Retrieve all emails for the specified email folder whose read status matches the specified one

use the above as the email folder
get some email folder's emails whose "isRead" is True