# Personio HRIS directory sync

<!-- Generated by scripts/generate.ts. Do not edit. -->

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.

:::caution[Verification]
Not yet verified on a real Personio tenant. It was written from the public Personio documentation, so labels in the admin console may differ slightly.
:::

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.

## Steps

<ol class="idp-steps">

<li class="idp-step">

<a id="credentials-page"></a>

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

:::caution[Labels not confirmed in step 1]
The menu path to the API credentials page is not confirmed by the public article; it is usually under the integration settings.
:::

</li>

<li class="idp-step">

<a id="access"></a>

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

</li>

<li class="idp-step">

<a id="generate"></a>

### Generate the credentials

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

</li>

<li class="idp-step">

<a id="credentials"></a>

### 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`](/errors/directory_source_credentials_invalid/), [`directory_source_unavailable`](/errors/directory_source_unavailable/)

</li>

<li class="idp-step">

<a id="preview"></a>

### Preview the first sync

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

</li>

<li class="idp-step">

<a id="interval"></a>

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

</li>

<li class="idp-step">

<a id="who"></a>

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

</li>

</ol>

## Sources

- [Generate and manage API credentials (Personio)](https://support.personio.de/hc/en-us/articles/4404623630993-Generate-and-manage-API-credentials), read on 2026-10-30
