Email
Research
Email engineering guide

Microsoft Graph email integration, end to end

A Graph mail connector combines Microsoft identity, least-privilege permissions, Outlook resource modeling, per-folder delta, change-notification renewal, sending, and tenant-aware recovery.

Research surface only. This guide documents architecture and evaluation criteria; it does not describe a released DewEngine connector.
01
Identity and consent

Model delegated and enterprise access separately

Use delegated permissions for a user-driven mailbox connection. Offer application permissions only for an explicit organizational use case with administrator consent, narrower internal authorization, and clear target-mailbox controls.

02
Operations

Keep Graph's native message context

Support list, get, draft, send, reply, move, and delete according to the promised capability matrix. Retain Graph IDs, folder IDs, conversation IDs, Internet Message-ID, change keys, categories, and attachment types.

  • Personal and organizational accounts as tested
  • Primary and shared mailbox context
  • Structured and MIME representations
  • Conditional write metadata
03
Synchronization

Run delta independently for every selected folder

Follow @odata.nextLink through a round and store @odata.deltaLink only after applying the folder changes. Use notification subscriptions to reduce delay, renew them before expiration, and run periodic delta reconciliation.

04
Tenant operations

Surface policy and consent failures accurately

Conditional Access, administrator policy, consent removal, shared-mailbox rights, and throttling can differ by tenant. Return actionable normalized errors with Graph diagnostic context and a reconnect or admin-consent path when appropriate.

  • Tenant and user identity
  • Permission and consent state
  • Subscription health
  • Per-mailbox sync lag
Questions

Before you build.

Are Mail.ReadWrite and Mail.Send the same permission?+

No. Graph permissions are capability-specific. Request the documented permissions for each operation and avoid assuming read/write mailbox access automatically grants every send scenario.

Can application permissions be used without administrator involvement?+

Generally no. App-only Graph access is an organizational trust decision and requires the applicable administrator consent and internal access controls.

Can I use DewEngine's email connectors today?+

Not yet. Gmail, Microsoft Graph, and IMAP/SMTP connectors are planned. This guide documents the intended architecture and the provider requirements a production release must satisfy.

Build with us

Does this match the workflow your users need?

DewEngine is in development. Real use cases decide what ships first.

Share your use case