Direct Connections

Outlook Calendar is the cloud calendar product offered by Microsoft as part of Microsoft 365.

How Worklytics Collects and Uses Outlook Calendar Data

Worklytics supports connecting to Outlook Calendar to analyze how people are collaborating via meetings and events in your organization.

To support this, Worklytics Outlook Calendar connectors request the following permissions grants:

• Directory.Read.All Allows Worklytics to read users from legacy Entra ID directory API, which includes all email addresses per user, to better match users across data sources. (Other grants pertain to Microsoft Graph API).

• Calendars.Read Read calendar events (meetings) for all users in the organization, which is the primary data imported by this connector.

• Contacts.Read used to understand external collaborators, or link email accounts not in your user directory to their proper owners.

• Group.Read.All used to disambiguate mailing lists. (eg, when someone invites [e-mail] to a meeting, if that's a mailing list in the Acme organization, we can understand the group of people the invite went to)

• MailboxSettings.Read provides user timezone preferences, working hours, vacation info, etc that are used in Worklytics' analysis.

• User.Read.All to iterate users calendars (if we don't know your users, we can't determine the resource ID for any calendar they may have)

• openid the OpenId protocol is used for the initial connection flow, to pass basic profile information about the person connecting the data source back to the Worklytics application.

Further reading: Microsoft Graph Permissions Reference

Connecting Worklytics to Outlook Mail

Your organization must have already have a provisioned Worklytics account to use these connectors.

A Global Administrator of your Entra ID instance must complete the following steps:

1. Visit the Data Connections screen inside Worklytics, and find the "Outlook Calendar" connector. Click "Connect".

2. A screen to authenticate with Microsoft will open in a new tab.
3. After authenticating with the Entra ID organization that you wish to connect, you'll be presented with a permissions screens that looks as follows. Click "Accept".

4. You'll be redirected back to Worklytics.