> ## Documentation Index
> Fetch the complete documentation index at: https://docs.juicebox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Recruitee Integration Set-up

> Enable the two-way integration between Recruitee and Juicebox.

## About the integration

Juicebox's integration with Recruitee allows you to:

1. **Export Profiles to Recruitee**: Save profiles directly into Recruitee, including contact details, current company and job, profile URLs, and more.
   1. **\[Configurable] Auto-Export:** Juicebox has the ability to auto-export profiles to your ATS with configurable triggers, including after shortlisting, after adding to a sequence, or after an interested response.
   2. **Custom Integration Fields:** On some plans, integration fields can be customized further based on your preferred fields.
2. **Link Recruitee Jobs to Juicebox**
   1. **Import Job Descriptions**: Import a job description from Recruitee into Juicebox to automatically kick off a search using the job description.
   2. **Simplify Exports:** When exporting a profile from Juicebox to the ATS, it will automatically be connected to the correct job in the ATS. More details [here](/projects).
3. **View Profiles in Recruitee**: View profiles already in Recruitee within Juicebox. Avoid reaching out to the same profile twice, and instantly view your relationship history.

### Start a project via the Recruitee integration

Open the projects page and select **Import Job from ATS / CRM**. You will then see your Recruitee jobs and can select the corresponding option.

### Export profiles to Recruitee

Follow the regular [export](/exports) steps and select **Export to Recruitee** on either an individual profile or a bulk export. After exporting, you will see the profile created in your Recruitee account.

### View profiles already in Recruitee

Juicebox will tag profiles that already exist in Recruitee. You will see the last modified date, as well as the option to view the profile directly in Recruitee by clicking the **View in ATS** button.

## Before you start

You must be an administrator of your Recruitee instance, or an admin must ensure your hiring role has sufficient permissions.

To verify that you are an administrator:

1. Click your profile picture in the top right corner.

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/hNFONOgCV-SCAIXl/images/help/ats-setup/recruitee-1.png?fit=max&auto=format&n=hNFONOgCV-SCAIXl&q=85&s=8bdfa091f24dabe9af700f463f436255" alt="Profile picture in the top right corner of Recruitee" width="2932" height="1606" data-path="images/help/ats-setup/recruitee-1.png" />
   </Frame>

2. Check that you see **Administrator** below your name.

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/hNFONOgCV-SCAIXl/images/help/ats-setup/recruitee-2.png?fit=max&auto=format&n=hNFONOgCV-SCAIXl&q=85&s=d4b5696b7c08c6564aa1260f14ede865" alt="Administrator label below the user name" width="2932" height="1606" data-path="images/help/ats-setup/recruitee-2.png" />
   </Frame>

## Configure a hiring role (admins only)

If you are the administrator of your Recruitee account and want to enable another user to set up the integration, update the permissions of that user's hiring role to match the permissions listed in the connection pop-up.

1. Click the cog icon in the top right corner.

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/hNFONOgCV-SCAIXl/images/help/ats-setup/recruitee-3.png?fit=max&auto=format&n=hNFONOgCV-SCAIXl&q=85&s=ac344abc6dc879571f614bc2d93346cc" alt="Cog icon in the top right corner of Recruitee" width="2936" height="1558" data-path="images/help/ats-setup/recruitee-3.png" />
   </Frame>

2. In the sidebar under **Company**, click **Hiring roles**.

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/hNFONOgCV-SCAIXl/images/help/ats-setup/recruitee-4.png?fit=max&auto=format&n=hNFONOgCV-SCAIXl&q=85&s=af3ded3e2a747ce5f240e63d290f21bb" alt="Hiring roles option under Company in the sidebar" width="2928" height="1596" data-path="images/help/ats-setup/recruitee-4.png" />
   </Frame>

3. Either click **Create new role** to create a new role, or click an existing role to edit it. In either case, make sure the user who should create the API token is assigned to the role you are configuring.

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/hNFONOgCV-SCAIXl/images/help/ats-setup/recruitee-5.png?fit=max&auto=format&n=hNFONOgCV-SCAIXl&q=85&s=3bb3ee79c11d879b02db4a91977900bd" alt="Creating or editing a hiring role" width="2938" height="1600" data-path="images/help/ats-setup/recruitee-5.png" />
   </Frame>

4. Edit the role to include all the permissions listed in the connection pop-up. The screenshot below is an example of possible permissions. Reference your own connection pop-up when selecting the permissions you add to the role.

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/qfiskEq6xdn4chGF/images/help/ats-setup/recruitee-6.png?fit=max&auto=format&n=qfiskEq6xdn4chGF&q=85&s=9128badb10459636f0e7b3f73779c0db" alt="Example permissions on a hiring role" width="696" height="960" data-path="images/help/ats-setup/recruitee-6.png" />
   </Frame>

## Create an API token in Recruitee

1. Click the cog icon in the top right corner.

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/hNFONOgCV-SCAIXl/images/help/ats-setup/recruitee-3.png?fit=max&auto=format&n=hNFONOgCV-SCAIXl&q=85&s=ac344abc6dc879571f614bc2d93346cc" alt="Cog icon in the top right corner of Recruitee" width="2936" height="1558" data-path="images/help/ats-setup/recruitee-3.png" />
   </Frame>

2. In the sidebar, click **Personal API tokens**.

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/qfiskEq6xdn4chGF/images/help/ats-setup/recruitee-7.png?fit=max&auto=format&n=qfiskEq6xdn4chGF&q=85&s=cc376a41572dac59cb947d30b11f1848" alt="Personal API tokens option in the sidebar" width="2940" height="1554" data-path="images/help/ats-setup/recruitee-7.png" />
   </Frame>

3. Click **New token** to create a new token.

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/qfiskEq6xdn4chGF/images/help/ats-setup/recruitee-8.png?fit=max&auto=format&n=qfiskEq6xdn4chGF&q=85&s=a7afb5f316fc7dd0dbc4fa8d43eeb942" alt="New token button" width="2918" height="552" data-path="images/help/ats-setup/recruitee-8.png" />
   </Frame>

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/qfiskEq6xdn4chGF/images/help/ats-setup/recruitee-9.png?fit=max&auto=format&n=qfiskEq6xdn4chGF&q=85&s=1f0163c2bc2da6627ba4766db7ce0e45" alt="Personal API tokens page after clicking New token" width="2044" height="188" data-path="images/help/ats-setup/recruitee-9.png" />
   </Frame>

4. Give the token any name that helps you remember it.

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/hNFONOgCV-SCAIXl/images/help/ats-setup/recruitee-10.png?fit=max&auto=format&n=hNFONOgCV-SCAIXl&q=85&s=e1ea55f7a1c0a2323f75275fac198d09" alt="Naming the new API token" width="1742" height="748" data-path="images/help/ats-setup/recruitee-10.png" />
   </Frame>

5. Recruitee sends you a code via email. Paste the code and click **Continue**.

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/hNFONOgCV-SCAIXl/images/help/ats-setup/recruitee-11.png?fit=max&auto=format&n=hNFONOgCV-SCAIXl&q=85&s=f079f841f2432af865403afb230ddaf0" alt="Entering the email verification code" width="1174" height="868" data-path="images/help/ats-setup/recruitee-11.png" />
   </Frame>

6. Copy the **token** and the **company ID**. You paste both into the connection pop-up in the next section.

   <Frame>
     <img src="https://mintcdn.com/juicebox-16ef85b6/hNFONOgCV-SCAIXl/images/help/ats-setup/recruitee-12.png?fit=max&auto=format&n=hNFONOgCV-SCAIXl&q=85&s=a4b4abb91df4f84f08aa662e6795e71c" alt="Copying the token and company ID" width="1506" height="765" data-path="images/help/ats-setup/recruitee-12.png" />
   </Frame>

## Setting up the integration

1. Navigate to the **Integrations** tab on the Juicebox platform.
2. Select **Recruitee** and click **Activate**. You can also use the search bar at the top.
3. Follow the instructions in the connection pop-up, pasting your token and company ID when prompted.
4. After you have clicked through the remaining pages of the pop-up, the configuration will be completed. If successful, you will see a green **Connected** button in your Integrations marketplace.

Congratulations! You have successfully integrated Recruitee and Juicebox.

<Note>
  It may take a few minutes for all data to sync between Juicebox and Recruitee.
</Note>

## Support

For an overview of all integration features, see [ATS Integrations](/ats-integrations). If you're facing any issues with your integration, contact our support team at [support@juicebox.ai](mailto:support@juicebox.ai).
