list-mail-messages
Retrieve and search email messages from Microsoft 365 accounts using KQL syntax to filter by sender, subject, body content, attachments, dates, and importance levels.
Instructions
Get an open extension (openTypeExtension object) identified by name or fully qualified name. The table in the Permissions section lists the resources that support open extensions. The following table lists the three scenarios where you can get an open extension from a supported resource instance.
💡 TIP: CRITICAL: When searching emails, the $search parameter value MUST be wrapped in double quotes. Format: $search="your search query here". Use KQL (Keyword Query Language) syntax to search specific properties: 'from:', 'subject:', 'body:', 'to:', 'cc:', 'bcc:', 'attachment:', 'hasAttachments:', 'importance:', 'received:', 'sent:'. Examples: $search="from:john@example.com" | $search="subject:meeting AND hasAttachments:true" | $search="body:urgent AND received>=2024-01-01" | $search="from:john AND importance:high". Remember: ALWAYS wrap the entire search expression in double quotes! Reference: https://learn.microsoft.com/en-us/graph/search-query-parameter
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| includeHiddenMessages | No | Include Hidden Messages | |
| top | No | Show only the first n items | |
| skip | No | Skip the first n items | |
| search | No | Search items by search phrases | |
| filter | No | Filter items by property values | |
| count | No | Include count of items | |
| orderby | No | Order items by property values | |
| select | No | Select properties to be returned | |
| expand | No | Expand related entities | |
| fetchAllPages | No | Automatically fetch all pages of results | |
| includeHeaders | No | Include response headers (including ETag) in the response metadata | |
| excludeResponse | No | Exclude the full response body and only return success or failure indication |