> For the complete documentation index, see [llms.txt](https://integrations.drivetrain.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://integrations.drivetrain.ai/integration-guide/integrate-with-drivetrain/hris-and-ats/integrating-with-peoplehr.md).
# 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**.
2. Go to **Settings > API** and click the **+** icon to create a new key.
3. Enter a **Key Name** (for example, *Drivetrain*) and, optionally, restrict the key to specific **IP Addresses**.
4. Under **Application Access**, select the areas Drivetrain should read — **Employee**, **Salary**, **Absence**, and **Holiday** — based on your use case.
{% hint style="info" %}
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.
{% endhint %}
5. Click **Save**.
6. 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.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://integrations.drivetrain.ai/integration-guide/integrate-with-drivetrain/hris-and-ats/integrating-with-peoplehr.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
