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.
Sign in to Recruitee as the user Metaintro should act as.
Go to Settings > Apps and plugins > Personal API tokens.
Select Add new token, give it a label such as "Metaintro", and select Save.
If Recruitee asks, enter your password to confirm it's you.
Select Show token and copy the token.
Copy your company ID. It's shown on the same Personal API tokens page.
Connect in Metaintro
In Metaintro, go to Settings > Integrations and choose Recruitee.
In Company ID, paste your company ID.
In Personal API token, paste the token.
Select Connect.
To get stage changes straight away, set up a webhook:
Copy the Webhook address that Metaintro shows after you connect.
In Recruitee, go to Settings > Apps and Plugins > Webhooks and select + New webhook (Recruitee's webhook guide).
Paste the address as the POST URL, choose the Move on pipeline event, and select Verify and create.
Copy the webhook secret from the same Webhooks page.
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.