Prerequisites
Before getting started, please carefully read the following to make sure you fulfil all requirements for the integration to work:
In order to set up the integration with Personio, you must at least have :
- A Personio CorePRO plan
- Access rights to the following roles:
- Account configuration > API (to create the API key)
- Account configuration > Marketplace Integration (to view the credentials of the created API key)
To make sure your account has access to these roles, please follow these steps:
-
Click on the "Settings" button in the sidebar (if you can not see this button, you are missing permissions). Then click on the "API credentials" tab in the "Security & Integrations" section under the "Settings" page:
-
Ensure that you can see "Connected Integrations".
If you can not follow these steps, you will not be able to set up this integration. Please ask a system administrator to assign these "access rights" to your account. You can read more about "access rights" here.
Find your API domain
Your API domain is the same domain that you use to login to Personio. You should also be able to see it in your browser:
Ensure XML feed is enabled
- Log into your Personio account.
- Open the settings by clicking the gear icon on the bottom left corner of the page and navigate to the “Recruiting” section:
- Click on the "Career page" tab on the navigation bar and make sure the "Enable XML feed" setting is toggled on:
Generate your Recruiting API credentials
- Log into your Personio account.
- Open the settings by clicking the gear icon on the bottom left corner of the page. From the settings page select “API Credentials” from the “Integrations” section
- Personio provides system-generated credentials for ATS APIs, we don’t need to generate new credentials. So, in the “API credentials” page the credentials should already be listed in the bottom as “Recruiting API key”.
- Click on the “Recruiting API key” row, a popup will appear on the page with the credential details.
- Copy the “Company ID” and “Access token” and paste it in the connection flow. Click on “Set up integration and you’re good to go.
Recruiting API Channel
-
Open the settings by clicking the gear icon on the bottom left corner of the page. From the settings page select “Recruiting” from the “Recruiting” section
- Next, under the dropdown on the right, select "Channels" and click on the "+" sign to add a new channel.
- Next, copy the value from the connection flow for the "Name of external channel" and set the pricing type as "None". Finally, press "Save"
- Go to the created channel, and copy the number underneath "Recruiting API channel ID":
- Finally, copy the above value into the connection flow, and press "Setup integration":
Generate your Personio API credentials
- Open the "API credential" page. You can follow the link in the connection guide or use the following link with your own subdomain:
https://<your subdomain>.personio.de/configuration/marketplace/connected
Click on "Create custom integration" on the marketplace page:
- Copy the name of the from the connection flow, and past into Personio:
- Please enable the acess right in Personio based on the information provided but the connection flow, and click on "Create integration":
- Copy the "client ID" and "API Secret" from Personio, and paste them into the connection flow, and click on "Set up integration" in the connection flow: