Outlook Mail

How Dispatch reads, drafts, sends, and organizes mail in your Outlook (Microsoft 365) account.

To connect Outlook Mail, open the in-app Connections settings.

Outlook Mail is one of two email backends Dispatch supports (the other is Gmail). The agent operates against your real Microsoft 365 mailbox through Microsoft Graph.

OAuth scopes

Dispatch requests the Microsoft Graph mail scopes it needs and no more. The in-app connect screen shows the current scope request before you authorize.

Read capabilities

  • List recent messages and search across your mailbox.
  • Read message bodies and full thread structure.
  • View individual messages and their metadata.
  • List folders and read folder structure.
  • List categories assigned to messages.
  • Read drafts.

Write capabilities

All writes carry the external-write risk annotation and pass through the permission gate.

  • Create drafts.
  • Send messages (new threads, replies, forwards).
  • Move messages between folders.
  • Modify categories on a message.
  • Create, update, and delete custom folders.
  • Create and delete custom categories.

Permanent message deletion is not exposed. Moving to a folder or archiving is reversible from the Outlook client.

What automations can use

  • Email received (OUTLOOK_EMAIL_RECEIVED): trigger on incoming messages matching a filter (sender, subject, category).
  • Email sent (OUTLOOK_EMAIL_SENT): trigger on messages the user sends.
  • Scheduled actions that read or write Outlook Mail. Scheduled actions can modify categories and folders; there is no separate category- or folder-change trigger.

Limits and behavior

  • Rate limits. Subject to Microsoft Graph's API quotas.
  • Multi-account. A user can connect multiple Outlook accounts; the agent disambiguates by address when it matters.
  • Send is gated. Send tools carry an external-write risk annotation and route through the permission gate. The gate consults your policy on every send once the permissionAgent enforcement flag is on for your org; while the flag is off the gate emits telemetry and lets the send through.
  • Categories vs. labels. Where Gmail uses labels, Outlook uses categories. The agent treats them as equivalent organizational primitives.

On this page