Before you start
You need a SmartRecruiters user with Administrator access. Only an Administrator can create an API key.
You will paste one thing into Metaintro: a SmartRecruiters API key.
An API key gives full access to your company's SmartRecruiters data, and it doesn't expire. Keep it somewhere safe, and revoke it in SmartRecruiters if you stop using Metaintro.
To have new candidates credited to Metaintro, an Administrator can add a custom source named Metaintro in SmartRecruiters first. If there isn't one, SmartRecruiters records the source as API.
Create the credential in SmartRecruiters
Sign in to SmartRecruiters as an Administrator and open Credential Manager.
Select New Credential, then choose API Key.
Enter a Credential name and a Description, for example Metaintro.
Select Generate.
Copy the API key from the pop-up. SmartRecruiters shows it only once.
SmartRecruiters' guide: API Key
Connect in Metaintro
In Metaintro, go to Settings > Integrations.
Choose SmartRecruiters.
In API key, paste the key you copied.
Select Connect.
Then map your SmartRecruiters jobs to your Metaintro jobs, set your rules, preview, and go live.
What Metaintro sends and reads
Metaintro only sends people who chose to share their profile with you for that job. For each person, Metaintro:
Adds them as a candidate on the matching SmartRecruiters job, with their name, email, phone when they shared one, their Metaintro proof card link as their website, and your Metaintro source if you made one.
Uploads their résumé to that job application when they shared one.
Posts a message on the candidate's profile, shared with the job's hiring team, with a link to their proof card and their short summary when they wrote one.
Before adding anyone, Metaintro looks for an existing candidate with exactly the same email. If that candidate is already on the job, Metaintro adds the résumé and message to their application instead of applying them again. If two candidates share the email, Metaintro stops and doesn't guess.
Metaintro checks each shared candidate's status on the job regularly. Interview shows as interviewing, Offered as offer, Hired as hired, Rejected as not selected, and Withdrawn as withdrawn. New, In review, Lead and Transferred don't change the stage in Metaintro.
When you move a candidate from Metaintro, it sets their status on the job: Interview, Offered, Hired, Rejected or Withdrawn. SmartRecruiters has no contacted status, so Metaintro can't set that one.
Limits
Stage changes reach Metaintro when it next checks, not instantly. Metaintro doesn't use SmartRecruiters webhooks.
Metaintro needs the person's email to add them. A person who shared no email can't be sent.
If your hiring process requires a sub-status before a status, or a reason for rejections and withdrawals, SmartRecruiters may refuse a move made from Metaintro. Make that move in SmartRecruiters instead.
SmartRecruiters allows 10 requests a second per API user and only one candidate search at a time. Metaintro paces its requests and waits when SmartRecruiters asks it to slow down.
Metaintro credits candidates only to a source named Metaintro. A source with a different name isn't used.
If something goes wrong
Key rejected. Check you pasted the whole key and that it hasn't been revoked in Credential Manager. If you lost it, generate a new key and paste it in Metaintro.
Missing permission. An API key can be limited to an access group. If SmartRecruiters refuses a job or candidate, check that the key's access group includes that job, or create a new key without that limit.
Candidates arrive with the API source. Add a custom source named Metaintro. Candidates sent after that are credited to it.
Rate limited. Metaintro pauses and retries on its own. No action is needed.