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:

1. Click on your profile picture in the top right corner
   
2. Validate that you can see Administrator below your name
   

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.

1. Click on the cog icon in the top right corner
   
2. In the sidebar under Company, click on Hiring roles
   
   
3. 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.
   
4. 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

1. Click on the cog icon in the top right corner
   
2. In the sidebar, click on Personal API tokens
   
   
3. Click on New token to create a new token, and paste the value into the connection flow
   
   
4. Give the token any name that helps you remember it
   
5. Caution: Recruitee will send you a code via email
   Paste the code and click on Continue
   
6. Now, copy the token and paste the value into the connection flow
   Also paste the company ID into the connection flow