Skip to content
English
Sign in
Contact us
  • There are no suggestions because the search field is empty.

How to Set Up the Microsoft Learn Sync Integration in Empath

Learn how to configure the Microsoft Learn Sync Integration in Empath. This guide explains setup, permissions, daily sync behavior, requirements, and limitations.

How to Set Up the Microsoft Learn Sync Integration in Empath

Summary

The Microsoft Learn Sync Integration allows Empath to automatically sync a user’s Microsoft Learn progress into Empath once per day. This gives MSPs an easy way to track assigned Microsoft Learn modules without requiring employees to manually document their completion. This guide explains how to set up the integration, how the sync works, what limitations to expect, and how to troubleshoot common issues.

Overview

Empath’s Microsoft Learn Sync Integration connects your Microsoft 365 tenant to your Empath tenant and retrieves daily Learn progress for your users. Once configured, Empath checks Microsoft Learn once per day and updates lesson and course progress for users whose email address matches between systems. The integration is currently in public beta, and functionality will expand as Microsoft improves the stability and scope of its Learn Graph API.

Prerequisites

Before configuring the Learn Sync Integration, you will need:

  • Empath Admin permissions (Managers cannot set it up, but Managers can view its status)

  • A Microsoft 365 account with permissions to approve Enterprise Applications

  • Your Microsoft Subscription ID

  • Matching email addresses between Microsoft Learn profiles and Empath user accounts

What the Learn Sync Integration Does

Once enabled, Empath will:

  • Sync Microsoft Learn progress once per day

  • Match progress to Empath users by email address first, then name

  • Apply progress only to assigned Empath content

  • Update lesson and course completion percentages based on Learn activity

  • Require no additional manual interaction after setup

This allows Microsoft-aligned technical development to flow into Empath reporting and accountability systems.

Current Limitations (Beta)

Because Microsoft’s Learn Graph API is still evolving, the following limitations apply:

  • Only future progress (after integration date) is synced

  • Historical progress cannot be imported yet

  • Only assigned Empath content is eligible for synced progress

  • Syncing occurs only once per day

  • Microsoft’s API may produce occasional inconsistencies or delays

Empath will expand this integration as Microsoft stabilizes and extends their API support.

How to Set Up the Microsoft Learn Sync Integration

Step 1: Navigate to Integrations

  1. Log in to Empath with an Admin account.

  2. Click your profile menu in the upper right corner.

  3. Select Settings.

  4. Choose Integrations from the left navigation panel.

You will see the Microsoft Learn Sync Integration listed alongside other Empath integrations.

Step 2: Enter Your Microsoft Subscription ID

  • The interface includes a small guide explaining where to find your Subscription ID.

  • Follow those instructions in your Microsoft 365 tenant.

  • Paste the Subscription ID into the designated field.

Step 3: Approve Required Permissions

You will be redirected to Microsoft’s standard Permissions Request screen, which may include:

  • Read user assignments

  • Read learning content

  • Maintain access to data you have granted

  • Read usage reports

  • Read directory data

  • Sign in and read user profiles

  • Read organization information

  • Manage learning content

These permissions allow Empath to retrieve Learn progress across your tenant.

Click Accept to authorize.

Step 4: Confirm Integration Status

After returning to Empath:

  • The integration card will show your active connection status.

  • The Admin who set up the integration is the only one who can remove it.

  • Managers can see that the integration is set up but cannot modify or reset it.

How the Daily Learn Sync Works

  • Empath contacts Microsoft Learn once every 24 hours.

  • Empath retrieves any newly recorded Learn progress.

  • Empath attempts to match progress to Empath users by email address (preferred) or by display name.

  • Only courses and lessons that are assigned in Empath will register progress.

  • Users will see updated progress in their assigned lessons and courses automatically.

Frequently Asked Questions

Why does the sync only apply to progress after the integration is set up?

Microsoft’s Learn API does not currently support stable retrieval of historical progress. When Microsoft releases broader capabilities, Empath will expand the sync accordingly.

Can multiple Admins configure the integration?

No.
Only the Admin who originally sets up the integration can remove or reconfigure it.

What if other Managers look at the Integrations page?

Managers who did not set up the integration:

  • Can see that the integration exists

  • Cannot modify or replace it

Why does progress only apply to assigned Empath content?

Assigned content ensures Empath can correctly map Learn modules to specific internal training objectives.

What if progress is not syncing correctly?

Check the following:

  • The user’s email address is identical in both systems

  • At least 24 hours have passed since the last sync

  • The user completed Learn content after the integration was enabled

  • The Empath lesson is assigned

If issues continue, open a support ticket and include any relevant Learn activity details.

Best Practices

  • Ensure all employees use the same email address in Microsoft 365 and Empath.

  • Assign courses before expecting Learn progress to sync.

  • Periodically check the Integrations page to confirm connection stability.

  • During rollout, verify that a handful of test users are syncing correctly before expanding to the full team.

Permissions Requested by the Empath Integration App

When you click Accept during setup, Microsoft lists the following permissions:

  • Read user’s assignments

  • Read learning content

  • Maintain access to data you have given it access to

  • Read all usage reports

  • Sign in and read user profile

  • Read directory data

  • Read all assignments

  • Read all learning content

  • Manage all learning content

  • Read all multi-tenant organization details and tenants

  • Read organization information

  • Read all users’ basic profiles

These permissions allow Empath to pull Microsoft Learn progress for users in your tenant and associate it with the correct Empath accounts.