---
title: "Connect Recruitee to Metaintro | Metaintro"
canonical: "https://www.metaintro.com/help/connect-recruitee-to-metaintro"
language: "en"
author: "Metaintro"
published: "2026-11-11T16:02:31.114Z"
modified: "2026-11-11T16:02:45.098Z"
---

# Connect Recruitee to Metaintro

Send candidates who chose to share with you straight into Recruitee, and get their stage changes back in Metaintro.

Last updated: November 11, 2026[Employers](/help/category/employers)

Paste it into Claude, ChatGPT, Codex, Cursor or Pi.

## Before you start

- You need a Recruitee user who can create personal API tokens. The token acts as that user, with the same role and permissions, so use a dedicated admin user for Metaintro. If that user leaves your company, the connection stops working.
- Recruitee's docs don't name a plan requirement for API tokens.
- For instant stage updates you also need the "Manage webhooks" ability on your hiring role (under Add-ons).
- You'll paste two things into Metaintro: your company ID and the personal API token.

## Create the credential in Recruitee

These steps follow Recruitee's guide, [Getting Started](https://docs.recruitee.com/reference/getting-started).

1. Sign in to Recruitee as the user Metaintro should act as.
2. Go to **Settings > Apps and plugins > Personal API tokens**.
3. Select **Add new token**, give it a label such as "Metaintro", and select **Save**.
4. If Recruitee asks, enter your password to confirm it's you.
5. Select **Show token** and copy the token.
6. Copy your company ID. It's shown on the same Personal API tokens page.

## Connect in Metaintro

1. In Metaintro, go to **Settings > Integrations** and choose **Recruitee**.
2. In **Company ID**, paste your company ID.
3. In **Personal API token**, paste the token.
4. Select **Connect**.

To get stage changes straight away, set up a webhook:

1. Copy the **Webhook address** that Metaintro shows after you connect.
2. In Recruitee, go to **Settings > Apps and Plugins > Webhooks** and select **+ New webhook** ([Recruitee's webhook guide](https://docs.recruitee.com/docs/webhooks)).
3. Paste the address as the **POST URL**, choose the **Move on pipeline** event, and select **Verify and create**.
4. Copy the webhook secret from the same Webhooks page.
5. Back in Metaintro, paste it into **Signing token** and select **Save token**.

## What Metaintro sends and reads

Metaintro only sends people who chose to share their profile with you for a specific job. For each person, Metaintro:

- creates a candidate in Recruitee, with "Metaintro" as the source, or finds the existing candidate with exactly the same email address
- adds them to the job you linked
- uploads their résumé when they shared one
- adds a note with a link to their proof card

Stage changes come back to Metaintro through the webhook. Metaintro also checks Recruitee regularly, so changes still arrive if the webhook is missing. Metaintro can also move a candidate to a matching stage or disqualify them using one of your disqualify reasons.

## Limits

- Recruitee allows 1,000 API requests per minute for each token. Metaintro paces its requests to stay under that.
- Recruitee sends up to 100 webhooks per minute (5 per minute on a trial account). Extra webhooks are delayed by about 10 minutes.
- Metaintro can't mark a candidate as hired in Recruitee, because Recruitee needs a work location for that. Hire them in Recruitee instead.
- Moving a candidate only works when your pipeline has a stage whose name matches, such as "Interview" or "Offer". Disqualifying needs a disqualify reason with a matching name, such as "Not a fit" or "Withdrew".

## If something goes wrong

- **The token is rejected.** Check that you copied the whole token and the right company ID. Tokens belong to one company, so create the token while signed in to the company you're connecting. If the user who created it was removed, create a new token as an active admin and connect again.
- **Metaintro can't create candidates or notes.** The token has the same permissions as the user who made it. Make sure that user's role can add candidates and notes in Recruitee.
- **Stage updates are slow.** Check that the webhook exists under **Settings > Apps and Plugins > Webhooks** and that the signing token in Metaintro matches its secret. Recruitee's **Logs** tab shows each webhook request and its response.
- **Rate limited.** Metaintro waits and tries again on its own. If it keeps happening, check whether other tools share the same token.

### Was this article helpful?

## Related Articles

- [Connect your ATS to MetaintroSend people who choose to share with you straight into your applicant tracking system, and see their stage in Metaintro.](/help/connect-your-ats-to-metaintro)

[Return to navigation](#main-navigation)