People sync keeps Workleap up to date with the tool where you already manage your employees, such as your HRIS. Once a day, Workleap adds new people, removes people who left, and updates their information, so you don't have to do it by hand.
Note: Only Administrators can see and manage people sync. Connecting and configuring an integration happens in Workleap Classic for now.
What people sync does
People sync runs once a day and copies information from your source tool to Workleap.
People: adds people who are new in your source tool and removes people who are no longer in it.
Information: updates names, emails, job titles, photos, and any other fields you map, such as department or hire date.
Managers: updates who reports to whom, when your source tool has that information. Workleap uses managers to build reporting lines, so syncing them saves you the most work.
Only one integration syncs at a time. We recommend turning on automatic invites in the integration's settings, so new people get an invite as soon as the sync adds them and can sign in without you doing anything.
How people sync matches people
People sync matches people differently the first time an integration syncs and on every sync after that.
On the first sync, Workleap matches people by email. Everyone who's already in Workleap must use the same email in Workleap and in your source tool.
After the first sync, Workleap recognizes each person by their ID in your source tool. If someone's email changes there, Workleap updates it at the next sync. Emails of people who belong to more than one Workleap workspace aren't updated automatically. Contact Workleap Support to change them.
People you add by hand after the first sync stay in Workleap, unless you turn on the option to clean up manually added people in the integration's settings.
Important: Before an integration syncs for the first time, make sure everyone you added by hand uses the same email in Workleap and in your source tool. On that first sync, people with a different email get a second profile, and people who aren't in your source tool are deactivated, or deleted if they never signed in. Administrators and people without a seat are never removed.
Choose a source
The source you choose decides what information Workleap can sync. Pick the tool that holds the most accurate information about your employees, especially their managers.
HRIS (human resources information system), such as BambooHR, Hibob, or Workday: syncs people and the fields you map, including managers. See How do I sync people from my HRIS?
Google Workspace: syncs people from your Google organization or groups. Managers and hire dates sync once you turn them on. See How do I sync people from Google Workspace?
Microsoft 365: syncs people from your Microsoft 365 tenant or groups, including managers. See How do I sync people from Microsoft 365?
Slack: syncs the members of your Slack workspace. Slack doesn't have manager information, so you need to set managers another way. See How do I sync people from Slack?
API Provisioning: syncs people from your own systems with the Workleap API.
The People sync page shows every integration available to your organization.
See your integrations
The People sync page lists every integration available to your organization and shows which one is syncing.
Log in to Workleap and go to Org settings > Integrations.
Open the People sync tab.
Each integration shows a status:
Active: this integration syncs once a day. The last sync time shows below its name.
Paused: this integration is connected, but it isn't syncing.
Reconnect needed: Workleap lost access to this tool. Your settings are saved, but you need to reconnect it. If this happens to the integration that syncs, it shows both Active and Reconnect needed.
No status: this integration isn't connected.
To find an integration, type its name in Search integrations.
Connect or manage an integration
Connecting and managing people sync integrations happens in Workleap Classic for now. Workleap takes you to the right page.
Log in to Workleap and go to Org settings > Integrations > People sync.
Select Connect next to the integration you want to add, or Manage next to one that's already connected.
In the One quick detour message, select Continue in Workleap Classic.
The integration's page opens in Workleap Classic in a new tab. For an HRIS that isn't connected yet, the list of integrations opens, so you can choose your HRIS there. For the full steps, see the article for your source.
To change which integration syncs, turn off the active integration in Workleap Classic, then set up and turn on the other one.
Reconnect an integration
An integration shows Reconnect needed when Workleap loses access to your source tool, for example when the account that connected it loses its permissions. Your settings are saved, but the integration doesn't sync until you reconnect it.
Log in to Workleap and go to Org settings > Integrations > People sync.
Select Manage next to the integration, then Continue in Workleap Classic.
On the integration's page in Workleap Classic, reconnect the account.
Check sync history
Sync history shows what each sync changed and any issues to fix. It's available in Workleap Classic.
Log in to Workleap and go to Org settings > Integrations > People sync.
Select Manage next to the active integration, then Continue in Workleap Classic.
In Workleap Classic, open the sync history.
Each sync shows how many people were added, removed, and changed, and any issues. Select a sync to see its details and download its report.
Limitations
Only one integration can sync at a time.
Connecting, configuring, reconnecting, and disconnecting an integration happen in Workleap Classic for now.
The first sync matches people by email only. People added by hand with a different email get a second profile.
Slack doesn't sync managers.
People sync runs once a day. Changes in your source tool show in Workleap after the next sync.
