Integrating with PeopleHR

Prerequisites

To connect PeopleHR to Drivetrain, you need:

• An active PeopleHR account

• Admin privileges on PeopleHR

• Admin privileges in Drivetrain

PeopleHR Setup

Drivetrain supports integration with PeopleHR via an API key. You generate the key from an account with administrator access and scope it to the data Drivetrain should read.

Step 1: Create an API key

1. In your PeopleHR account, open HR Admin.

1. Go to Settings > API and click the + icon to create a new key.

2. Enter a Key Name (for example, Drivetrain) and, optionally, restrict the key to specific IP Addresses.

1. Under Application Access, select the areas Drivetrain should read — Employee, Salary, Absence, and Holiday — based on your use case.

The Salary area controls access to compensation data. Include it only if your Drivetrain use case requires salary or pay information. To pull salary or employment history, also include the History area, as historical fields are only returned on the per-employee detail call.

1. Click Save.

2. Click the copy icon to copy the key, and store it securely.

Drivetrain Setup

Step 1: Add the API key and complete the integration

1. Log in to Drivetrain as an administrator.

2. Click + New Data Source.

3. Select PeopleHR from the list of connectors.

4. Enter the PeopleHR API key you copied.

5. Click Finish Setup.

Drivetrain validates the key and begins the initial sync. Once the sync completes, the PeopleHR datasets appear on the Data page.