Skip to main content

Microsoft Entra ID Integration Guide

This article explains how the native Microsoft Entra ID integration works with Formalize and provides a step-by-step guide on how to install and configure it.

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

  1. Go to Settings > API and Integrations. Find the Microsoft Entra ID section and click Learn more.

    Integrations list

  2. On the Microsoft Entra ID details page, click 'Request installation', and then click 'Request access'.
    ​

    Request installation page


    ​

  3. 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]).
    ​

    Request pending screen

Phase 2: Completing Installation.

  1. Once approved, the status button on the Entra ID page will change from 'Request pending' to 'Install'.
    ​

  2. Click 'Install' and select ‘Authorize’ on the pop-up window.
    ​

  3. In the new Microsoft window, select the administrator account you want to link.
    ​

  4. Choose ‘Accept’ on the Permissions requested page.
    ​

  5. 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.

Did this answer your question?