How the Microsoft Entra ID Integration Works
The Entra ID integration automatically synchronizes your organization's directory data into Formalize, helping you manage your personnel seamlessly.
Before installing, please review these important sync behaviors:
Imported as Resources: Profiles synced from Entra are added to Formalize as Employees in Resources, not active system users. This means they will not have login access to Formalize.
Group syncing: You may filter for specific groups from Entra ID to sync. Only members of these specific groups will be imported.
How to Install the Entra ID Integration
Prerequisite: You must have administrator permissions in your Microsoft workspace to authorize this connection.
Phase 1: Requesting Access
Go to Settings > API and Integrations. Find the Microsoft Entra ID section and click Learn more.
On the Microsoft Entra ID details page, click 'Request installation', and then click 'Request access'.
Wait for approval - The button will change to Request pending. Our team typically reviews and approves these requests on the same day. (If it takes longer than 24 hours, contact [email protected]).
Phase 2: Completing Installation.
Once approved, the status button on the Entra ID page will change from 'Request pending' to 'Install'.
Click 'Install' and select ‘Authorize’ on the pop-up window.
In the new Microsoft window, select the administrator account you want to link.
Choose ‘Accept’ on the Permissions requested page.
A success message will appear in Formalize. Click 'OK'.
Managing Your Integration
Once successfully connected, you will be prompted to select the Entra ID groups to import. Once you've selected the desired groups, click on the Save and start import button.
The time of your next scheduled synchronization (syncs occur automatically once a day at the same time).
A green "Installed" verification badge.
A Synchronize employees button to manually sync immediately.
A Configure button to add or remove groups for future imports.
An Uninstall button to uninstall the integration.
💡 Removal of groups: When you remove a group from the integration configuration, members of that group will not be imported during the next synchronization. Any previously imported members must be removed manually from the Employees module as removing the group does not automatically de-provision previously imported employees.










