Generate Personio API credentials with read access to employees, enter the client ID and secret in this setup, and we read your employees every few minutes.
The values in braces, such as {acs_url}, are specific to your connection. The setup link from the application you are connecting shows them with a copy button. The same steps appear there.
-
Open the API credentials page
Section titled “Open the API credentials page”Sign in to Personio as an admin who can manage integrations and open the page for API credentials of custom integrations.
-
Allow reading employees
Section titled “Allow reading employees”Create a credential for OhAuthCat and give it Read access to Employees, not Write. In the Readable employee attributes list, select at least first name, last name, email, status, position and department; attributes you leave out are not shared with us.
-
Generate the credentials
Section titled “Generate the credentials”Generate the credential and copy the Client ID and the secret. Store the secret safely until you enter it here.
-
Enter the credentials in this setup
Section titled “Enter the credentials in this setup”Enter the client ID and client secret. We sign in and read your employees once to check them before saving them encrypted; if the check fails, nothing is saved.
Fixes:
directory_source_credentials_invalid,directory_source_unavailable -
Preview the first sync
Section titled “Preview the first sync”Select Preview to see who would be added, updated and removed, without changing anything.
-
Choose how often we read Personio
Section titled “Choose how often we read Personio”We read Personio every 5 minutes by default. You can set any interval from 5 minutes to 24 hours. After a failure we wait longer between tries, up to an hour.
-
Know who is synced
Section titled “Know who is synced”Every sync reads every employee page. Inactive employees and people Personio no longer returns are removed from the directory, and departments become groups.
Sources
Section titled “Sources”- Generate and manage API credentials (Personio), read on 2026-10-30