Articles on: General

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)


Click "Add integration"

How do I configure the webhook?

  1. Go to Settings → Integrations → Added tab. (Hailey HR)
  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.
  4. Copy the "Hailey Company Id" shown on this screen and send it to the RightPerson admin. They need it to link your account.




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
  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.


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 for assistance.



📩 Need help?


Do you have questions?
📩 Send us an email at support@rightperson.com – we’ll be happy to help!

Updated on: 08/09/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!