Deel can connect to and sync data with Microsoft Entra using the dedicated integration. This article explains how to configure Deel and Microsoft Entra so that you can sync data between them.
In this article
Here’s what you’ll find in this article:
- Before you begin
- Step 1. Connect the integration
- Step 2. Configure the integration
- Step 3. Sync data
- Troubleshooting
- Microsoft Entra integration reference
Before you begin
To successfully set up the Microsoft Entra integration, you’ll need:
- A user with a Global Administrator role on Microsoft Entra
- A user with an admin role on Deel
We also recommend checking the Microsoft Entra integration reference to understand features and limitations of the integration before starting to follow this guide.
Step 1. Connect the integration
In this section, we’ll guide you through how to connect Deel to Microsoft Entra.
To connect to Microsoft Entra:
1. Go to More > Apps and search for Microsoft Entra in the App Store.
2. On the integration page, click Connect Microsoft Entra.
3. Complete the login to your Microsoft Entra admin account.
The integration is now connected and you’ll be taken back to the integration page on Deel.
Once connected, an automatic sync will begin to match your accounts between Deel and Microsoft Entra. Depending on the number of workers, this may take some time.
Step 2. Configure the integration
In this section, we’ll guide you through configuring the integration so that data can sync successfully.
After connecting Microsoft Entra, configuring it consists of
Configure the user provisioning plugin
This plugin is used to automatically create Microsoft Entra accounts for new hires and suspend accounts upon termination.
To configure the user provisioning plugin:
1. From the Microsoft Entra integration page, go to the Plugins and settings tab.
2. Next to the User provisioning plugin, click Enable.
3. Choose the events you want to sync.
The User Provisioning Plugin is configured, new hires will be automatically provisioned in Microsoft Entra, and terminated accounts will be suspended.
Any HR fields which change on Deel will be synced. For instance, changes to a job title will be updated in Microsoft Entra after the next sync.
Configure the People match plugin
This plugin is used to manually match workers that weren’t matched automatically after connecting the integration.
To configure the people matching plugin:
1. From the Microsoft Entra integration page, go to the Integrations Plugins and settings tab.
2. Go to the People matching plugin.
3. From the list of unmatched accounts, manually select the correct Microsoft Entra account email for each worker to match.
The People Match plugin is configured, any workers not automatically matched during the initial setup will be manually linked to their corresponding Microsoft Entra accounts.
Step 3. Sync data manually
Automatic syncs occur daily, one way from Deel to Entra, but you can manually trigger a sync:
- If you’ve made important changes and need them to sync immediately
- If you notice missing data or errors that suggest that the last sync didn’t complete correctly
To sync data, go to the Microsoft Entra integration page and click Sync Microsoft Entra.
Recent changes in employee data will be synced from Deel to Microsoft Entra.
Troubleshooting
This section includes instructions and workarounds to troubleshoot common issues.
[ACCORDION] Newly created Deel accounts without corresponding Microsoft Entra accounts won’t be matched.
Take note that this only happens when user provisioning is disabled. If user provisioning is enabled, a newly created Deel account, based on the rules set, should automatically get created in Microsoft Entra.
To solve this:
1. Go to People > Worker > Apps.
2. On the Apps page, select Microsoft Entra and click Create account.
3. On the Microsoft Entra account creation modal, select when to grant access.
The Microsoft Entra account is created and the username is displayed.
[/ACCORDION]
Microsoft Entra integration reference
This section provides information about the capabilities and limitations of the integration. You can use it to understand whether the integration can sync the data you need to sync.
Supported contract types
The Microsoft Entra integration supports the following contract types:
- Independent contractor
- Employer of record (EOR)
- Global payroll
- Professional employer organization (PEO)
Supported sync entities
The Microsoft Entra integration supports the sync of the following entities:
- Employee data
- First Name
- Last Name
- Department
- Job title
- Hiring type
- Start date
- End date
- Cost center
- Address