Microsoft Outlook 365

Source

Polytomic connects to Microsoft Outlook 365 using one of two methods:

  • OAuth: this can only obtain emails from the authenticated user's connected mailbox and any shared mailbox their user account can see.
  • Client credentials: these credentials have access to every mailbox the parent Microsoft app registration can see.

Connecting with OAuth

  1. In Polytomic, go to Connections → Add Connection → Microsoft Outlook 365:
  1. Select OAuth as your authentication method.

  2. Click Connect to Microsoft Outlook 365 to connect to Microsoft Outlook 365 using OAuth.

  3. Click Save.

Connecting with client credentials

Client credentials are recommended if you would like Polytomic to sync from multiple mailboxes in one go:

  1. In the Microsoft Entra admin center, go to Entra ID → App registrations → New registration. You can set this to be single tenant and no redirect URL is required.
  2. Go to API permissions → Add a permission → Microsoft Graph → Application permissions and add the Mail.Read and User.ReadBasic.All permissions. Click Grant admin consent for and enable admin consent for both these permissions. The connection won't work without this.
  3. Go to Certificates & secrets → Client secrets → New client secret. Create a secret and copy its value (it's only shown once).
  4. In Polytomic, go to Connections → Add Connection → Microsoft Outlook 365.
  5. Select Client credentials as your authentication method.
  1. Paste the Directory ID, client ID, and client secret from Step 3.
  1. Click Save.

Syncing from Microsoft Outlook 365

Use Bulk Syncs to sync and ETL emails from Microsoft Outlook 365 to your Polytomic Harbors, databases, data warehouses, and cloud storage buckets.