Skip to main content

Import Your Employee Directory from Entra ID (Azure AD)

Sync your Microsoft Entra ID (formerly Azure AD) users with Swif's employee directory, so onboarding, offboarding, and directory management stay up to date.

Benefit

What it means

One directory

Your Entra ID users appear in Swif, ready for devices and access

Automatic syncing

With auto-sync on, changes in Entra ID reach Swif at the next sync

Faster onboarding

New Entra ID users are added to Swif, so you can provision their devices sooner

Choose who's synced

Import everyone, or only specific users or groups


Requirements

Item

Details

Swif

Permission to add employees and connect HRIS integrations

Microsoft

An account that can grant consent for your organization, such as a Global Administrator

Swif needs read-only access to your Entra ID directory.


Connect Entra ID

  1. In Swif, go to Employees > Add Employees > Connect New HRIS, and select Connect to Azure AD.

  2. Sign in with your Microsoft account, and accept the permissions Swif asks for.

  3. Click Sync, and choose what to import:

    • Full import: Everyone in your directory

    • Limited import, by users: Only the users you pick

    • Limited import, by groups: Only the members of the Entra ID groups you pick

  4. Choose whether to turn on auto-sync for this import. See Auto-sync below.

  5. Check that the users appear in Swif's Employee Directory.


Auto-sync

Auto-sync keeps Swif up to date with Entra ID after the first import. It's useful when you only import certain groups, and want Swif to pick up changes as you make them in Entra ID.

Auto-sync is off by default for new connections. Turn it on when you import.

What auto-sync updates

Import

New users added

Existing users' details updated, such as an address change

Full import

✅

✅

Limited import, by users

—

✅

Limited import, by groups

✅

✅

With auto-sync on for a group, adding or removing users from the group in Entra ID changes the group's members in Swif at the next sync.

Choosing groups for a limited import

  • Groups you've already synced still appear in the list, with their sync and auto-sync status.

  • A group synced without auto-sync is grayed out, and can't be selected again.


See sync status

Where

What it shows

HRIS tag

User groups imported from Entra ID have a tag showing where they came from

Last sync column

Whether the last sync was Full or Limited

HRIS Details panel

What the last sync added. For a full import, the users synced. For a limited import, the groups synced, and the users added.


FAQ

What permissions does Swif need in Entra ID?

Read-only access to your directory, to sync employee details. Swif doesn't change anything in Entra ID.

Can I choose which users are synced?

Yes. Choose Limited import, then pick specific users, or specific Entra ID groups. Entra ID doesn't have organizational units (OUs), so you choose by user or by group.

Why can't I select a group I synced before?

It was synced without auto-sync. Groups synced without auto-sync can't be selected again.

Why didn't a new user appear in Swif?

  • Check that auto-sync is on for the import.

  • With a limited import by users, new users aren't added automatically. Add them in a new import, or import by group.

  • With a limited import by groups, check that the user is a member of a synced group in Entra ID.

  • Changes appear at the next sync.


Related resources

Did this answer your question?