List message metadata

listMessageMetadata lists mailbox or folder messages with minimal mail access. Use it when routing depends on headers and state rather than message content.

Example

automations/list-unread-mail.automation.ts

import { automation } from "automate.ax"
import { listMessageMetadata } from "automate.ax/outlook"

export default automation("List unread Outlook mail", () => {
  listMessageMetadata({
    folder: "inbox",
    filter: "isRead eq false",
    orderBy: "receivedDateTime desc",
    limit: 50,
  })
})

Inputs

folder optionally accepts a display path, ID, or well-known name. filter and orderBy are Microsoft Graph OData expressions. limit defaults to 100 and accepts 1–10,000. account defaults to the project Microsoft binding.

Output

Returns OutlookMessage[] without body or preview. Each record includes messageId, subject, recipients, read/draft/attachment state, categories, importance, flag, folders, conversation and internet IDs, timestamps, sender, Focused Inbox classification, web link, and ETag when Graph supplies them. Invalid OData expressions fail at Microsoft Graph.

⌘I

Get started

Concepts

Reference

List message metadata

Example

Inputs

Output

​Example

​Inputs

​Output

Example

Inputs

Output