Before you start
You need a Manatal admin. Only admins can see Open API tokens.
Your account needs Manatal's Open API feature. It is included and switched on by default on the Enterprise Plus plan. On other plans, ask Manatal support to enable it first.
You will paste one thing into Metaintro: a Manatal Open API token.
Create the credential in Manatal
These steps follow Manatal's guide, Manatal Open API.
Sign in to Manatal as an admin.
Select Administration in the side menu.
Open the Features category, then Open API.
If the feature isn't on yet, select Contact our support to ask Manatal to enable it. Come back once it is on.
Select Generate new token.
Copy the new token using the copy icon next to it.
Connect in Metaintro
In Metaintro, go to Settings > Integrations.
Choose Manatal.
In Open API key, paste the token you just generated.
Select Connect.
Then map your Metaintro jobs to Manatal jobs, set your rules, check the preview and go live.
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 Manatal, with the source set to Other and Metaintro as the detail. If a candidate with the same email address already exists, Metaintro uses that one instead.
Adds the candidate to the Manatal job you mapped.
Adds their résumé when they shared one. Manatal downloads it from a link that Metaintro sends.
Adds a note with a link to their proof card and a short summary.
Metaintro reads your Manatal jobs so you can map them. It checks each shared candidate's stage regularly, so a move in Manatal shows up in Metaintro after a short delay. When you move a candidate in Metaintro, it moves them to the matching stage in that job's Manatal pipeline, if there is one.
Limits
The Open API is part of Enterprise Plus. On other plans, Manatal support has to enable it.
If a payment is missed or your plan is downgraded, Manatal deactivates existing tokens. You will need to generate a new one and connect again.
Stage updates are checked regularly, not sent instantly. Manatal's webhooks have no documented way to prove they came from Manatal, so Metaintro doesn't use them.
Manatal doesn't publish a rate limit. If it asks Metaintro to slow down, Metaintro waits and tries again.
If something goes wrong
The token is rejected. The token may have been deleted or deactivated. Generate a new one under Administration > Features > Open API and connect again.
You can't see Open API. You need to be an admin, and the feature must be on. If it isn't, select Contact our support on that page, or email support@manatal.com.
Too many requests. Metaintro waits and retries on its own. You don't need to do anything.
A candidate didn't arrive. Check that the job is still mapped and open in Manatal. If a stage didn't move, check that the job's pipeline has a stage with a matching name, such as Interview, Offer or Hired.