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

# Recruitee

> Connect Recruitee to Octanist to track candidate movement and lead conversions automatically.

The Recruitee integration allows you to synchronise candidate pipeline movements with Octanist, enabling automated lead qualification and offline conversion tracking.

## Table of Contents

1. [Create the Integration in Octanist](#1-create-the-integration-in-octanist)
2. [Configure the Webhook in Recruitee](#2-configure-the-webhook-in-recruitee)
3. [Complete the Setup in Octanist](#3-complete-the-setup-in-octanist)

***

## 1. Create the Integration in Octanist

1. Go to [Octanist](https://octanist.com/) and navigate to **Integrations > Updating > Add New**.
2. Choose **Recruitee** and click **Set up Recruitee**.

<Frame>
  <img src="https://mintcdn.com/octanist/jWnqIwbrxMke9RJn/images/octanist-integration-updating-add-recruitee.png?fit=max&auto=format&n=jWnqIwbrxMke9RJn&q=85&s=0bbc09d11496042453db7fd45f176b93" alt="Octanist Integration Updating Add Recruitee" width="813" height="436" data-path="images/octanist-integration-updating-add-recruitee.png" />
</Frame>

3. Copy the **POST URL**, you will need this in the next step.

<Frame>
  <img src="https://mintcdn.com/octanist/jWnqIwbrxMke9RJn/images/octanist-integration-updating-webhook-recruitee.png?fit=max&auto=format&n=jWnqIwbrxMke9RJn&q=85&s=72cd2ea49369b7fe8672bdbd69556c0c" alt="Octanist Integration Updating Webhook Recruitee" width="1236" height="676" data-path="images/octanist-integration-updating-webhook-recruitee.png" />
</Frame>

***

## 2. Configure the Webhook in Recruitee

1. Go to [Recruitee](https://app.recruitee.com/) and log in.

<img src="https://mintcdn.com/octanist/oPap-GrRplwUCjVH/images/recruitee/recruitee-click-on-settings.png?fit=max&auto=format&n=oPap-GrRplwUCjVH&q=85&s=24249b7a2d297d9b4b83867df6331fb1" alt="Recruitee Click On Settings" title="Recruitee Click On Settings" style={{ width:"35%" }} width="214" height="115" data-path="images/recruitee/recruitee-click-on-settings.png" />

2. Click the **Settings** icon in the top-right corner.

<img src="https://mintcdn.com/octanist/oPap-GrRplwUCjVH/images/recruitee/recruitee-app-and-plugins.png?fit=max&auto=format&n=oPap-GrRplwUCjVH&q=85&s=ea4c5c0da5b2908908bccd2d44f14c69" alt="Recruitee App And Plugins" title="Recruitee App And Plugins" style={{ width:"58%" }} width="398" height="340" data-path="images/recruitee/recruitee-app-and-plugins.png" />

3. In the left sidebar, scroll down to **Apps and Plugins** and click **Webhooks**.
4. Find the **Secret** and click **Show Secret**.

<img src="https://mintcdn.com/octanist/oPap-GrRplwUCjVH/images/recruitee/recruitee-webhook-secret.png?fit=max&auto=format&n=oPap-GrRplwUCjVH&q=85&s=7b0b2c61ba8fb799eec1aaaca2c554e4" alt="webhook.png" width="937" height="252" data-path="images/recruitee/recruitee-webhook-secret.png" />

<Warning>
  You may be asked to verify your identity before revealing the secret.
</Warning>

5. After verification, **copy the Webhook Secret**, you will need this in the next step.
6. Click **New Webhook**.

<img src="https://mintcdn.com/octanist/oPap-GrRplwUCjVH/images/recruitee/recruitee-click-new-webhook.png?fit=max&auto=format&n=oPap-GrRplwUCjVH&q=85&s=3992274883b34b90244ae749b8984fcc" alt="Recruitee Click New Webhook" width="889" height="561" data-path="images/recruitee/recruitee-click-new-webhook.png" />

7. Fill out the fields:
   * **Name**: for internal use only (e.g., *Octanist - Your Organisation Name*)
   * **URL**: paste the **POST URL** copied from Octanist
   * **Event**: select **Only the Move on pipeline**

<img src="https://mintcdn.com/octanist/oPap-GrRplwUCjVH/images/recruitee/recruitee-webhook-fill-in-the-fields.png?fit=max&auto=format&n=oPap-GrRplwUCjVH&q=85&s=75e860ba87e8dfd949fa9b3acaa1401a" alt="Recruitee Webhook Fill In The Fields" width="693" height="729" data-path="images/recruitee/recruitee-webhook-fill-in-the-fields.png" />

8. Click **Verify and Create**.

***

## 3. Complete the Setup in Octanist

1. Return to Octanist and paste the **Webhook Secret** into the corresponding field.

<Frame>
  <img src="https://mintcdn.com/octanist/1pDKuIW_o-RmQEj1/images/recruitee-api-secret-recruitee-incoming-integration.png?fit=max&auto=format&n=1pDKuIW_o-RmQEj1&q=85&s=f6f97a6a81bdd954458428adeadacd67" alt="Recruitee Api Secret Recruitee Incoming Integration" width="1215" height="485" data-path="images/recruitee-api-secret-recruitee-incoming-integration.png" />
</Frame>

2. Click **Next** and configure the deal stages. Select the Recruitee stage that corresponds to each of the following:
   * **Lead is Qualified**: e.g., *First Interview*
   * **Lead is Won**: e.g., *Hired*

<Warning>
  The stage name must **exactly match** the stage name in Recruitee.
</Warning>

<Frame>
  <img title="Deal Stages in Recruitee for Octanist" className="hidden dark:block" src="https://mintcdn.com/octanist/jWnqIwbrxMke9RJn/images/image-1.png?fit=max&auto=format&n=jWnqIwbrxMke9RJn&q=85&s=c0c70f57c3bf1cb650b2bf88f9fd65cb" alt="Deal Stages in Recruitee for Octanist" width="1185" height="571" data-path="images/image-1.png" />

  <img title="Deal Stages in Recruitee for Octanist" className="dark:hidden" src="https://mintcdn.com/octanist/1pDKuIW_o-RmQEj1/images/recruitee-deal-stages-recruitee-incoming-integration.png?fit=max&auto=format&n=1pDKuIW_o-RmQEj1&q=85&s=6ff26eeb6c3dd5b4de93661b4051bd6a" alt="Deal Stages in Recruitee for Octanist" width="1185" height="571" data-path="images/recruitee-deal-stages-recruitee-incoming-integration.png" />
</Frame>

3. Enter the **deal values**. These are the values sent alongside Google Ads, Meta, GA4, and other conversion platforms.
   * **Qualified leads**: enter a value representative of the potential value of a hire.
   * **Hired candidates**: enter a higher value that represents the value of a successfully hired candidate.

<Frame>
  <img src="https://mintcdn.com/octanist/1pDKuIW_o-RmQEj1/images/recruitee-deal-values-recruitee-incoming-integration.png?fit=max&auto=format&n=1pDKuIW_o-RmQEj1&q=85&s=668b3b9f8ceec9256e0b74b0e20e8ad2" alt="Recruitee Deal Values Recruitee Incoming Integration" width="1216" height="574" data-path="images/recruitee-deal-values-recruitee-incoming-integration.png" />
</Frame>

4. Give the integration a name and complete the setup.

<Frame>
  <img src="https://mintcdn.com/octanist/1pDKuIW_o-RmQEj1/images/recruitee-finalize-recruitee-incoming-integration.png?fit=max&auto=format&n=1pDKuIW_o-RmQEj1&q=85&s=5acb481dcbead59c9d375c50b500009a" alt="Finalize Recruitee Integration of Octanist" width="1156" height="415" data-path="images/recruitee-finalize-recruitee-incoming-integration.png" />
</Frame>

***

You are all set! Please test the integration by moving a candidate within Recruitee.

If you have any questions about this setup, contact us at [support@octanist.com](mailto:support@octanist.com).
