Articles in this section

Set up a connection to Personio

Naga Sri Hari Gonaboyina
Updated

Personio is a cloud-based HR and applicant tracking software that offers a comprehensive suite of HR tools to manage employee data, recruiting, time tracking, and more, simplifying HR processes and compliance.

Set up a connection

After you start the connection, configure it in the Create connection panel and complete all of the required * authentication settings:

Setting

Instructions

Name your connection * 

Enter a clear and distinguishable name.

Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.

API type * 

Choose the Personio API type you're connecting to:

  • Personnel data: Manage employees, attendances, absences, projects, custom attributes, and documents to automate core HR operations and sync staffing and time data.

  • Recruiting: Retrieve open job positions, submit applications, upload candidate documents, and manage recruiting attributes to support hiring workflows and applicant tracking.

API type: Personnel data

API version

Select your Personio account API version (v1 or v2).

Client ID * 

Enter your Personio client ID.

dataLoad.svg​​ How to retrieve the client ID

Client secret * 

Enter your Personio client secret.

Multiple layers of protection, including AES 256 encryption, are in place to keep your client secret safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

dataLoad.svg​​ How to retrieve the client secret

OAuth 2.0 client *  (only for v2 APIs)

Select the OAuth 2.0 client that stores the client ID and client secret provided to you by Personio.

To add an OAuth 2.0 client and configure your credentials, click the plus (+) button. Click the edit (pencil.svg) button to modify a selected OAuth 2.0 client. For more information, see Create an OAuth 2.0 iClient resource

dataLoad.svg​​ How to retrieve the client ID and client secret

API type: Recruiting

Token * 

Enter your Personio token.

Multiple layers of protection, including AES 256 encryption, are in place to keep your token safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

dataLoad.svg​​ How to retrieve the token

Company ID * 

Enter your Personio company ID.

dataLoad.svg​​ How to retrieve the company ID

Tip

This connector documentation describes only the settings shown for the Simple view. For the corresponding HTTP settings, see the Token universal connector documentation.

How to retrieve the client ID and client secret

  1. Sign in to your Personio account.

  2. Navigate to Settings > Integrations > API credentials and click Create custom integration.

  3. Enter a Name and click Next.

  4. Check the Permissions and Attributes.

  5. Click Create integration.

  6. Copy the Client ID.

  7. Copy the API secret (Client secret).

  8. Click Finish.

How to retrieve the company ID and token

  1. Sign in to your Personio account.

  2. Navigate to Settings > Integrations > API credentials.

  3. Click Recruiting integrations.

  4. Copy the Access token.

  5. Copy the Company ID.

Additional references