Skip to main content
All CollectionsIntegrationsHRIS Integrations
Setting up the Microsoft Entra ID integration
Setting up the Microsoft Entra ID integration

Our Entra integration allows you to sync your employee data with Insightful - completely automatically

Written by Katarina Dakic
Updated over a week ago

Our HRIS integrations are available on all of our packages.

Before you get started

Before setting up the integration, we recommend you read our guide on how the integration works to make sure it fits with how you want to manage Insightful.

Take a look at our guide and FAQs on How our HRIS integrations work.

You can see what Entra fields we sync with Insightful at the end of this article.

1. Determine which Entra groups represent teams to be synced with Insightful

Before you get started with an integration, one essential step is necessary for successful setup.

To simplify user management, Entra uses groups to organize users based on common or shared traits. This allows individuals to belong to multiple specific groups, rather than just one team.

For Insightful to accurately assign employees to appropriate teams or establish new ones, we need to determine which groups represent teams to be integrated into Insightful and which do not.

To enable Insightful to recognize the groups for synchronization, you must define teams in Entra groups by simply adding the following prefix before the group name:


By adding this prefix before the group name, Insightful can effectively recognize and match the groups between Entra and Insightful.

Please note, the prefix will be not visible within Insightful Employee Team information.

2. What will happen to your existing data?

Once integrated, integration will override already existing employees' information. The integration will:

  • Update existing employee profiles in Insightful with information found in the HR tool.

  • Assign employees to the right teams.

  • Deactivate employees in Insightful who have been offboarded in the HR tool.

Connect Entra to Insightful

Integrating Entra with Insightful couldn’t be simpler. First, you need to connect Entra to Insightful, and your employees will immediately start syncing.

Please note, that only the Admins can see the integrations and activate them.

To get started head to your Settings → Integrations Card → Directory Tab choose your HR provider and follow the steps required by your company’s HR software.

After you click on Configure Integration, you will be prompted to activate integration first. You will then be guided through the step-by-step screens.

Once you click on the Activate button, you will be prompted to authenticate yourself with Entra software.

The sync is completed within a couple of minutes...

... after which you will be prompted with a matching screen to review and manually match any unmatched employees.

During the synchronization process, we distribute employees to the appropriate teams within Insightful. To ensure that the right people are placed in the correct teams, the team name must be the same in both Entra and Insightful.

If we do not find an existing team from Entra in Insightful, we will create a new one. The newly created team will always be labeled as New on the matching screen.

Ensure you are certain about the matched employees before clicking the Finish button, as there is no undo option after this step.

Incorrect matches can result in changes to employee details like name, email, and team. If a wrong match occurs, you will need to unmatch the employee or match them to the correct person to rectify the data, which can be a cumbersome process. To avoid the hassle, double-check matches before finalizing.

When integration is completed, you will receive a notification.

And voilà! Your employees are now synced, and distributed into the right teams, and their data is enriched.

After you've set up the integration

1. Edit Matched Employees​

If you need to edit employee matches after integration is complete, you can do so by clicking on the Match Employee button in the integration overview.

When you click the Match Employee button, you will be directed to the Matching Screen once more. You will be able to:

  • Unmatch employees who are already paired, simply click on 'x'

  • Match already matched employees with other employees

2. Deactivation

You can also deactivate the integration at any point. After deactivation, we will stop syncing the data, and all the data that is already synced will stay in our system.

What fields do we sync from Entra?

  • Employee's first name

  • Employee's last name

  • Employee's work email

  • Employee's employment status - if they are active or not active employees

  • Employee's group

Entra doesn't support the Job title ID field for integration, so that shouldn't be able to import.

Entra fields which we pull into Insightful:

Employee's group:

Did this answer your question?