Prerequisites
Before getting started, please carefully read the following to make sure you fulfill all requirements for the integration to work:
You are an administrator of your Recruitee instance, or an admin has ensured that your hiring role has sufficient permissions.
To verify that you are an administrator:
Click on your profile picture in the top right corner
Validate that you can see Administrator below your name
Open the Connection flow in HiPeople
Navigate to HiPeople and Log In. Click on your user name on the bottom left, and then Settings. Locate the Integrations option on the list on the left.
(Direct link here: https://app.hipeople.io/settings/org/integrations).
On the Integrations page, locate and click Recruitee under the Automate in HiPeople (Pull Integration) category.
In the first screen, you will see what permissions HiPeople will have by enabling the integration. Click Continue.
Configuring a Hiring Role
If you are the administrator of your Recruitee account and want to enable another user to set up the integration, you will have to update the permissions of the user's hiring role to match the expected permissions mentioned in the connection flow.
Go to Recruitee, and click on the cog icon in the top right corner.
In the sidebar under Company, click on Hiring roles.
Either click on Create new role to create a new role, or click on an existing role to edit it. In either case, ensure that the user who should create the API token is assigned to the role you are configuring.
Edit the role to include all the permissions listed in the connection flow.
The screenshot below is an example of possible permissions. Please make sure that you are referencing your unique connection flow when selecting the permissions you are adding to the role.
Creating API credentials
Click on the cog icon in the top right corner.
In the sidebar, click on Personal API tokens.
Click on New token to create a new token.
Give the token any name that helps you remember it.
Caution: Recruitee will send you a code via email. Paste the code and click on Continue.
Now, copy the token and paste the value into the connection flow.
Also, paste the company ID into the connection flow.
Click Continue to finish the set up flow.
That's it, you'll see a confirmation that your connection is set up correctly, and you're set!
Now that your integration is live, you can either create jobs manually in HiPeople and link them to your existing Recruitee jobs, or turn on ATS Sync to have jobs created automatically in HiPeople whenever new ones are added in Recruitee. You can learn more about ATS Sync here.
For information on how to use the ATS automation and link specific Jobs in HiPeople to Jobs in Recruitee, check out this article: Integrating a job with your chosen ATS.