CogLake User Guide
Connectors

Microsoft 365 email

Index authorized Exchange Online messages through Microsoft Graph.

This is a Knowledgebase connector, not an AI Workspace automation email trigger. It reads mailbox content through Microsoft Graph, not SMTP.

  1. Register an Entra Web application as described in the SharePoint guide.
  2. Select Microsoft 365 / Exchange in CogLake's Add connector wizard. Copy its own callback ending /api/coglake/connectors/oauth/email-exchange/callback into Entra. Do not reuse the SharePoint callback.
  3. Configure delegated Graph permissions User.Read, Mail.Read, Mail.Read.Shared, offline_access, openid, profile, and obtain required administrator consent.
  4. Enter tenant ID, client ID, client secret value and mailbox. The signed-in account must have access to that mailbox; shared mailbox access requires the corresponding Microsoft delegation.
  5. Connect at Microsoft, return to Sync, choose folder scope and CogLake role permissions, then save.

Verify a known message in search after indexing. Treat mailbox data as sensitive: prefer a restricted mailbox/folder selection and test an unauthorized user. If access fails, check both the OAuth grant and Microsoft mailbox permissions. See scope and access.