Before you start
Only a Homerun admin can create the key Metaintro needs. Your company must be on a paid Homerun plan. Trial accounts can't use Homerun's Public API.
You will paste one thing into Metaintro: a Homerun API key with these five scopes:
vacancies:read
job-applications:read
job-applications:write
job-application-files:write
job-application-notes:write
Homerun doesn't let you change a key's scopes later, so tick all five when you create it.
Create the credential in Homerun
Sign in to Homerun as an admin.
Open Settings from the sidebar.
Go to Company, then Public API.
Select Generate V2 API key.
Under Scopes, tick the five scopes listed above.
If you like, set an Expiry date. The connection stops working on that date.
Select Generate.
Copy the key now. Homerun shows it only once. Then select Done.
If you lose the key, delete it and generate a new one. Homerun's guide: How to generate our public API key.
Connect in Metaintro
In Metaintro, go to Settings > Integrations.
Choose Homerun.
In API key, paste the key you copied.
Select Connect.
Metaintro checks the key by reading your Homerun jobs and candidates. Then map your Homerun 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 Homerun job, with their name, email and phone when they shared them. The candidate is marked as sourced, with Metaintro as the source.
Adds their Metaintro proof card link as the candidate's website.
Uploads their résumé when they shared one.
Adds a note from Metaintro with a link to their proof card and a short summary.
If a candidate with the same email is already on that job, Metaintro uses that candidate instead of adding a new one. It doesn't upload the same résumé or add the same note twice. Metaintro doesn't send Homerun's confirmation email to the candidate.
Homerun doesn't send hiring updates to other apps, so Metaintro checks each shared candidate's stage regularly. Candidates you mark as hired show as hired, and disqualified candidates show as not selected. Other stages are read by name, so stages such as Interview or Offer show up in Metaintro. When you move a candidate from Metaintro, it picks the stage on that Homerun job whose name matches. If no stage name matches, nothing changes in Homerun.
Limits
Homerun allows 60 API requests a minute. Metaintro paces its requests to stay under that, so large batches take a little longer.
Stage updates are not instant.
Homerun only accepts new candidates on jobs that are public or private. Draft and closed jobs can't receive candidates.
To find an existing candidate, Metaintro looks through up to 1,000 candidates on a job. On a busier job, the share stops with an error rather than risk adding the same person twice.
Notes are cut at 2,000 characters, Homerun's limit. The proof card link always comes first.
Homerun accepts résumé files up to 25 MB.
Metaintro doesn't answer your job's application form questions.
If something goes wrong
The key is rejected. It may have been copied wrongly, deleted, or past its expiry date. Generate a new key and connect again.
Homerun says your plan doesn't include the API. The Public API needs a paid plan, and trials are excluded. Upgrade your plan, then connect again.
A permission is missing. The key was made without one of the five scopes. Scopes can't be changed, so generate a new key with all five and connect again.
Too many requests. Metaintro waits and tries again by itself. You don't need to do anything.
A candidate didn't arrive. Check that the Homerun job is public or private, not draft or closed.