How to connect to Personio

To create a connection with Personio, you have to complete these steps.

1. Log in to Personio

After you have signed up for a Personio partner, you can log in to Personio.

Go to the Personio login page of your account, which you can find here. Personio - Configure API credentials

Enter your email address and password and click on the "Login" button.

3. Configure Personio API credentials

In the sidebar, click on "Settings" Personio - Navigate to settings

Next navigate to the "Integrations" and click on "API credentials". Personio - Manage API credentials

Click "Generate new credential" on the top right of the screen.

In the form that slides in, complete the following information: ![Personio - Configure API credentials](Personio - Configure API credentials

  • In the "Name" field, enter a meaningful name (for example, 'Apideck integration') for the credentials.
  • If applicable, select the relevant integration from the "Integration" drop-down menu. If not, select "Other".
  • Use the checkboxes to define the desired access levels. If you have selected an integration, the recommended access levels will be pre-selected.

If you select "Read" for Employees, the "Readable employee attributes" drop-down menu will appear. ![Personio - Define Employee attributes](Personio - Configure API credentials Choose the employee attributes that should be transferred from Personio. If you have selected an integration, the recommended attributes will be pre-selected.

If you are finished, click "Generate new credential", which will generate the API credentials. Personio - Configure API credentials

Copy the API key and the API secret and save them in a secure place. You will need them in the next step.

More details on the configuration of API credentials be found in the online help of Personio.

2. Vault Connection Setup

Now that you have your Personio API credentials, you can enable the integration to connect to your Personio instance in a secure manner.

Personio - Allow access