Before you start
Only onlyfy admin users can create API keys.
Your onlyfy plan must include the REST API. If you cannot see Integration > REST API in your account settings, ask your onlyfy contact.
You will paste one thing into Metaintro: an onlyfy API key.
Create the credential in onlyfy
These steps follow onlyfy's REST API documentation.
Sign in to onlyfy as an admin.
Open your account settings.
Go to Integration > REST API.
Create a new API key for Metaintro.
Copy the key.
onlyfy also offers OAuth client credentials on the same page. Metaintro uses the API key.
Connect in Metaintro
In Metaintro, go to Settings > Integrations.
Choose onlyfy.
In API key, paste the key.
Select Connect.
Then map your 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.
Jobs: Metaintro reads your onlyfy jobs that are not finished so you can map them.
Candidate: Metaintro looks for an existing candidate with the same email address. If there is none, it creates one with their name, email and phone. onlyfy does not email the candidate.
Application: the candidate is applied to the mapped job with Metaintro as the referrer. If your application sources include one named Metaintro, the application uses it.
Résumé: attached to the application as a recruiter file the candidate cannot see.
Proof card: onlyfy has no notes in its API, so the link to the person's proof card goes in the cover letter, with a short Metaintro delivery reference.
Metaintro checks each application in onlyfy regularly and reads its status. Metaintro can also move the application to the status in the job's status set that matches the step.
Limits
A person without an email address cannot be sent.
If the person already has an application on that job that Metaintro did not send, Metaintro does not send them again.
onlyfy has no stage webhooks, so changes reach Metaintro on its next check, not right away.
onlyfy does not publish rate limits. Metaintro paces its requests.
If something goes wrong
The key is rejected: onlyfy answers an invalid key with "forbidden". Check you copied the whole key and that it still exists under Integration > REST API. Then connect again.
A job is missing: finished jobs are not listed. Check the job is still running in onlyfy.
A person was not sent: check that they have an email address and do not already have an application on that job.