Get Outlook Emails

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

📘

Note: This operation is part of the Outlook Book (BDK). To use this book, you need to 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

ConceptDescriptionTypeRequired
email folderThe email folder from where the emails will be retrievedoutlook email folderYes

Output Concepts

ConceptDescriptionType
email folder's emailsAll the emails for the email folderoutlook 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 "tomas@ms.kognitos.org"

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