> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://faq.rightperson.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Hailey HR integration

# Hailey HR integration 
A step-by-step guide for connecting a customer's Hailey HR account with RightPerson so that background checks start automatically when a new employee is added, and the result flows straight back into Hailey.
## What do the two sides exchange?
RightPerson admin provides you:
* The Webhook URL
* The Webhook username and password (Basic Authentication)
You give to the RightPerson admin:
* The Hailey Company ID (from the webhook settings screen).
* The Hailey API Key (an Access Token generated in Hailey).
## How do I add the "Api" integration?
In Hailey, go to Settings → Integrations → API tab. ([Hailey HR](https://demo.haileyhr.app/settings?item=integrations&tab=OpenApi))
![](https://storage.crisp.chat/users/helpdesk/website/-/5/e/8/7/5e8787bd8ceb4800/image_1jay8a.png)

Click "**Add integration"**
## How do I configure the webhook?
1. Go to Settings → Integrations → Added tab. ([Hailey HR](https://demo.haileyhr.app/settings?item=integrations&tab=Added))
2. Open the Api integration you just added and fill in:
    * **Webhook URL** → the address the RightPerson admin gave you (ends in /hailey/webhook). 
    * **Authentication** → choose **Basic Authentication.** 
    * **Username** and **Password** → the values the RightPerson admin gave you.
3. **Copy** the "**Hailey Company Id**" shown on this screen and send it to the RightPerson admin. They need it to link your account.
![](https://storage.crisp.chat/users/helpdesk/website/-/5/e/8/7/5e8787bd8ceb4800/image_8d87bf.png)

![](https://storage.crisp.chat/users/helpdesk/website/-/5/e/8/7/5e8787bd8ceb4800/image_a55a2f.png)


## Which custom employee fields do I need to create?
RightPerson writes its results back into two fields you create here. **The names must match exactly** (same spelling, same capitalisation) or the write-back won't work.
1. Go to **Settings** → **Customisation** → **Employee Fields.** [__Hailey HR__](https://demo.haileyhr.app/settings?item=customisation_settings&tab=EmployeeFields)
2. Add two Text fields (placing them in the Job section is recommended):
    * `RightPerson Status`
    * `RightPerson Report Url`
## How do I generate an API Key (Access Token)?
RightPerson needs a key to read employee details and write results back.
1. In the Hailey admin, click on your user at the bottom-left.
2. Open Access Tokens → Generate.
3. Copy the token immediately and send it to the RightPerson admin. ⚠️ Hailey only shows the token once - if you lose it you must generate a new one.
![](https://storage.crisp.chat/users/helpdesk/website/-/5/e/8/7/5e8787bd8ceb4800/image_zczl9p.png)

## What happens when I'm done?
That's it!
Once you've completed the steps above and provided the Hailey Company ID and API Key to the RightPerson admin, everything is set up.
If you experience any issues during the setup or the results are not appearing in Hailey as expected, please contact your RightPerson admin <support email> for assistance.


## 📩 Need help?

Do you have questions? 
📩 Send us an email at [__support@rightperson.com__](mailto:support@rightperson.com) – we’ll be happy to help!