Before you start
You need a Personio user with API access rights. Personio only shows the option to create your own integration on the Core Pro plan.
You will paste two things into Metaintro: a client ID and a client secret.
Create the credential in Personio
These steps follow Personio's guides, Generate and manage API credentials and Get started with the Personio API.
Sign in to Personio.
Go to Marketplace > Connected integrations.
Select Create custom integration.
Give it a name, such as Metaintro.
In the access rights, set Recruiting to Read and Write.
Save. Copy the client ID and the secret Personio shows you. Keep the secret somewhere safe.
Connect in Metaintro
In Metaintro, go to Settings > Integrations.
Choose Personio.
In Client ID, paste the client ID.
In Client secret, paste the secret.
Select Connect.
Then map your Metaintro jobs to Personio 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:
Submits an application to the Personio job you mapped. Personio creates the candidate, or uses the candidate it already has with that email address.
Tags the application Metaintro.
Uploads their résumé as a CV when they shared one.
Puts a link to their proof card and a short summary in the application's message, because Personio has no way to add notes to an application.
Metaintro reads your Personio jobs so you can map them. It checks each shared person's stage regularly, so a move in Personio shows up in Metaintro after a short delay.
Limits
Personio needs an email address for every application. People who didn't share an email can't be sent.
If the person already applied to that job in Personio, Metaintro can't add a new packet to the existing application. You'll see an error for that person instead.
Metaintro can't move people between stages in Personio, and can't add notes. Move candidates in Personio and Metaintro picks up the change.
Stage updates are checked regularly, not sent instantly. Personio has no recruiting webhooks.
Personio doesn't publish rate limits for its recruiting API. If it asks Metaintro to slow down, Metaintro waits and tries again.
If something goes wrong
The credentials are rejected. Check you copied the full client ID and secret. If the integration was deleted, create a new one and connect again.
Missing permission. Edit the integration in Marketplace > Connected integrations and make sure Recruiting has both Read and Write.
You can't see Create custom integration. Check your plan includes it and your user has API access rights.
Too many requests. Metaintro waits and retries on its own. You don't need to do anything.
A candidate didn't arrive. Check the job is still mapped in Metaintro and still exists in Personio, and that the person shared an email address.