Skip to main content
You need access to Personio Settings > Integrations to create API credentials. Admin or appropriate permissions are required.

​
Create a Custom Integration

Create a custom integration in your Personio account to generate API credentials.

1

Access Integrations

Navigate to the Integrations page in Personio Settings.

  • Log in to your Personio account
  • Go to Settings > Integrations > API credentials
  • Click Create a custom integration
2

Enter Integration Info

Provide a name to identify your integration.

  • Enter a name (e.g., “StackOne Integration”)
  • Click Next to continue
3

Configure Access Rights

Select the permissions your integration needs. Choose Read and/or Write access for each module.

  • Select access rights for modules (employees, attendances, time off, documents, custom reports, compensations, recruiting, webhooks, org units, legal entities, cost centers, workplaces)
  • Required: Grant Read access for Employees - the connection will fail without this permission
  • Grant Read access for other modules you need to retrieve data from
  • Grant Write access for modules where you need to create or update data
  • Optional: Configure readable employee attributes if needed
  • Optional: Choose legal entities to scope access to specific entities
  • Click Create integration after selecting permissions
4

View and Copy Credentials

Your API credentials are now ready. Copy and store them securely.

  • Copy the Client ID (format papi-xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
  • Click Copy secret to copy the Client Secret
  • Critical: Store the Client Secret immediately in a secure place - it won’t be shown again
  • If you lose the secret, you’ll need to create a new integration

​
Important Notes

Key information about Personio API authentication.

  • Access tokens are automatically refreshed using the Client Credentials flow
  • Permissions configured during setup determine which API endpoints you can access
  • Keep your Client Secret secure and never share it publicly
  • You can manage or revoke integrations anytime in Settings > Integrations > API credentials
  • If you need to change permissions, create a new integration with updated access rights
  • Refer to the Personio API documentation for more information

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Client ID
  • Client Secret
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.