WorkOS Docs Homepage
Integrations

Access People HR

Learn about syncing your user list with Access People HR.

This guide outlines how to synchronize your application’s Access People HR directories.

To synchronize an organization’s users and groups provisioned for your application, you’ll need the following information from the organization:

  • Access People HR API key

Note: The Access People HR integration isn’t enabled by default in the WorkOS Dashboard or Admin Portal. Please reach out to support@workos.com or via your team’s WorkOS Slack channel if you would like Access People HR enabled.

The organization will need to create an API key for you. First, they’ll need to log in to their Access People HR admin dashboard and select to the “Settings” page from the side bar menu. Then, select “API” from the Settings side bar menu. On the API Key Management page, select the plus sign to add a new API Key.

A screenshot showing where to find the plus sign in the Access People HR Dashboard.

In the API Key Generator, give the API Key a descriptive name. Under “Application”, select “Employee”.

A screenshot showing where the "Employee" option is location in the Access People HR Dashboard.

On the Select Permissions page, check only “Get All Employee Detail” and then select “Save”.

A screenshot showing where to select the "Get All Employee Detail" permission is located in the Access People HR Dashboard.

On the API Key Generator page, select “Save”.

A screenshot showing the API Key Generator page in the Access People HR Dashboard.

Copy and save the API key – this will be used in Step 3.

A screenshot showing the copy icon in the Access People HR Dashboard.

Login to your WorkOS dashboard and select “Organizations” from the left hand Navigation bar

Select the Organization you’d like to enable an Access People HR Directory Sync connection for.

On the Organization’s page click “Manually Configure Directory”.

A screenshot showing where to find “Manually Configure Directory” for an Organization in the WorkOS Dashboard.

Select “Access People HR” as the Directory Provider, and then provide a descriptive name for the connection. Select “Create Directory”.

A screenshot showing Create Directory details in the WorkOS Dashboard.

In the directory details section, select “Update Directory”.

A screenshot showing where to find "Update Directory" in the WorkOS Dashboard.

Enter your API Key from Step 1, and select “Save Directory Details”.

A screenshot showing where to enter your API Key in the WorkOS Dashboard.

Now, you should see users and groups synced over from Access People HR.

Departments from Access People HR are synced as groups in WorkOS. All users are synced, but only those marked as “ACTIVE” or “LEAVER_MARKED” have a state of active.

How often do Access People HR directories perform a sync?

Access People HR directories poll every 30 minutes starting from the time of the initial sync.