Go to YourCampus
Personio integration
Aleksandra avatar
Written by Aleksandra. Updated over a week ago

By setting up the integration between Personio and YourCampus you will achieve following:

  • All the existing (active) employees in your Personio account will be added to YourCampus

  • Any future mutations in Personio (activation or deactivation of employees) will automatically be synced with YourCampus on a daily basis.

Setting up the integration consists of the following steps:

  1. Creating an API key in Personio

  2. Sharing the API Client ID and Secret with YourCampus support

  3. YourCampus activates the integration.

Optional: If you would like to selectively sync employees, this can be achieved by adding a custom attribute in Personio to indicate if an employee is eligible for YourCampus or not. These additional optional steps are described at the bottom of this article.

Step 1: Creating a Personio API Key for Integration

The following instructions will show you how to create a new API key in order to set up an integration with YourCampus:

  1. Log in to Personio as an administrator

  2. Go to the Settings -> Integrations -> API Credentials section

  3. Click on “Generate new credential”

  4. Input a Name for the integration such as “YourCampus API Key”

  5. Select Other in the Integration field

  6. Click the checkbox for Read for the Employees personal data row

  7. For the Readable employee attributes select the following fields:

    1. Birthday

    2. Email

    3. First Name

    4. Last Name

    5. Status

    6. Hire Date

    7. Termination Date

    8. Department

  8. Click on “Generate new credential”

Step 2: Sharing the credentials with YourCampus

Share this (Client ID and Secret) via an encrypted secret sharing service (1password, onetimesecret.com, etc) with your Customer Success Representative at YourCampus.

Step 3: Activation of the integration

As soon as the integration is activated, YourCampus support will inform you of this.

Optional: Selective syncing of employees

If you would like to selectively sync employees, this can be achieved by adding a custom attribute in Personio to indicate if an employee is eligible for YourCampus or not. Complete the steps below to set this up:

Adding the custom field

  1. Navigate to Settings -> Integrations -> Employee Information

  2. Add a new field, preferably in the HR Information tab as seen in the image below:

  3. In the “Name of your attribute” field type “YourCampus”

  4. In the “What type of attribute is it?” dropdown, select the “List of options” type

  5. Add “Yes” and “No” as options:

Setting the custom field in the User Profile

Set the default answer to “No”, so employees will not be synced unless specified so in the Personio User Profile section:

Returning the attribute with the API

In order for the new attribute to be used in the integration, it needs to be configured via the API:

  1. Head on to the Settings -> Integrations -> API Credentials section

  2. Select the API key configured for YourCampus

  3. Select the attribute (custom field) that you just created:

Did this answer your question?