Integrating your People Directory connects your existing directory provider (such as Workday, BambooHR or Google Workspace) with Perkbox. The main benefit is automating your onboarding and offboarding processes for starters and leavers.
When you activate employee accounts or make changes in your directory provider, these updates will automatically reflect in Perkbox and trigger the corresponding action.
For example, when you add a new employee in Workday – let’s call her Jane – a new user called Jane will be created in Perkbox and Jane will receive a welcome email from us.
Updates also include:
Deactivating an employee in your directory provider
Name changes
Email changes
These changes will be reflected automatically in Perkbox.
Which providers can I link with?
WorkOS currently supports a wide range of providers including Google Workspace, Microsoft Entra ID (formerly Azure AD), Okta, Workday, BambooHR, Hibob (Bob) and more.
Please check the latest provider list directly with WorkOS.
What data does each provider automate?
Basics include: first name, last name, email address, employment status and team name (if applicable).
Providers set up using SCIM or SAML do not sync employee start dates.
Provider | Feature(s) enabled | Automatically synced data |
Okta
| HRIS & SSO
| Basics
|
Google Workspace
| HRIS & SSO
| Basics
|
Azure AD (Microsoft aka Office 365) | HRIS & SSO | Basics |
Workday
| HRIS
| Basics & Employee Start Date |
BambooHR | HRIS | Basics & Employee Start Date |
Hibob | HRIS | Basics & Employee Start Date |
Fourth | HRIS | Basics
|
Rippling
| HRIS
| Basics
|
Breathe HR | HRIS | Basics & Employee Start Date |
Access People HR | HRIS
| Basics & Employee Start Date |
OneLogin
| HRIS & SSO | Basics
|
CyberArk
| HRIS & SSO
| Basics
|
Cezanne | HRIS
| Basics & Employee Start Date |
Personio
| HRIS
| Basics & Employee Start Date |
JumpCloud
| HRIS & SSO
| Basics
|
PingFederate
| HRIS & SSO
| Basics
|
What if my provider isn't listed?
Let us know your provider and we’ll notify you when WorkOS adds support for it.
How do I enable Link your People Directory?
Step one – Select Integrations from the left-hand menu in your Admin Dashboard.
Step two – Select Learn more in the Link your People Directory section.
Step three – Select Get started.
Step four – Select your HRIS.
Step five – Review and agree to the key terms, then select Next.
Step six – Confirm your primary account contact details, agree to the terms and conditions and select Purchase.
Step seven – Once your purchase is confirmed, you’ll receive instructions on how to complete the setup.
FAQs
How do I change my people's details after I enable the People Directory integration?
How do I change my people's details after I enable the People Directory integration?
All changes must be made in your directory provider. Updates can take up to 30 minutes to appear in Perkbox.
You can still assign employees to teams directly in Perkbox.
How do I prevent some employees (e.g. part-time workers or contractors) from being added to Perkbox?
How do I prevent some employees (e.g. part-time workers or contractors) from being added to Perkbox?
This depends on your directory provider.
Segmentation is currently possible only via:
Okta
Microsoft Entra ID / Azure
Google Workspace
Ask your IT team to manage this.
For providers like Workday, Rippling and BambooHR, segmentation isn’t possible – users added in these systems will sync to Perkbox.
What happens if I disable the People Directory integration?
What happens if I disable the People Directory integration?
All existing user details in Perkbox will remain as they are.
However, Perkbox will no longer receive any updates from your directory provider, and changes will need to be made manually.
Do I need to manually add new joiners?
Do I need to manually add new joiners?
No. When a new joiner is activated in your directory provider, Perkbox will automatically create a user account and send an activation email.
Do I need to manually deactivate leavers?
Do I need to manually deactivate leavers?
No. When you remove an employee from your directory provider, they will be automatically deactivated in Perkbox.
How do I assign global employees to the correct region?
How do I assign global employees to the correct region?
Regions are not synced automatically.
Upon activation, users must select the region they are based in to receive relevant local perks.
How do I add people to teams in Perkbox after enabling the integration?
How do I add people to teams in Perkbox after enabling the integration?
Team details sync automatically from your directory provider, or you can manage team assignments manually in Perkbox via the Teams page.
Will enabling the People Directory create duplicate users?
Will enabling the People Directory create duplicate users?
Perkbox uses email address to identify users.
If the same email address exists in Perkbox and your directory provider, the accounts will be merged and updated.