Personio

Sign in to Personio

Sign in to the Personio website and click on the Settings tab on the left-hand side menu.

Navigate to API credentials

In the Settings menu, scroll down to the “Integrations” section and click on “API credentials”.

Create custom integration

On the “Connected integrations” page, click the “Create custom integration” button.

Enter integration details

In the first step of the integration creation dialog, enter a name for your integration, and then click on the Next button.

Select permissions

In the second step, select the data types you want to grant access to. You must select at least one permission to continue. Common options include:

• employees (Read/Write)
• attendances (Read/Write)
• Time off (Read/Write)
• documents (Read/Write)
• Recruiting (Read/Write)
• Webhooks (Read/Write)

Choose employee attributes (Optional)

Create integration

Copy API credentials

Once the integration is created, you’ll see your API credentials displayed:

• Client ID: A unique identifier for your integration
• API Secret: A secret key for authentication

Copy both values to a secure location. You can use the “Copy” buttons provided.

Copy API credentials

Paste API credentials

Enter company name

Copy your company name from your Personio account, then paste your company name inside the Personio app id; please make sure the name is in capital letters.