Skip to content
Dashboard
Theme
Theme

Personio HRIS directory sync

Set up directory sync from Personio

View Markdown

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.

  1. Sign in to Personio as an admin who can manage integrations and open the page for API credentials of custom integrations.

  2. 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.

  3. Generate the credential and copy the Client ID and the secret. Store the secret safely until you enter it here.

  4. 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

  5. Select Preview to see who would be added, updated and removed, without changing anything.

  6. 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.

  7. Every sync reads every employee page. Inactive employees and people Personio no longer returns are removed from the directory, and departments become groups.