Skip to content

Personio

Personio

Connect Personio and your people are kept in step with it: an account from their start date, deactivated — every session signed out — at the end of their last day, and each department a group your administrators can map to roles.

In Personio

In the portal, open Directory sync, choose Using an HR system?, and pick Personio. Then, in Personio:

  1. In Personio, go to Settings → Integrations → API credentials and choose Generate new credentials. Name them "Cbox ID".
  2. Grant read access to persons and to org units (personio:persons:read, personio:org-units:read), and nothing that writes.
  3. Copy the client ID and client secret — the secret is shown once — and paste them here.

What to paste into the portal

Field Where it comes from
Client ID From Settings → Integrations → API credentials.
Client secret (secret) Shown once, when the credentials are generated.

The portal checks these with Personio before anything is stored, and never shows a secret again.

What happens next

  • The first sync starts straight away and runs in the background; the portal shows how it went.
  • After that, Personio is read in full about every hour.
  • A person whose termination date has passed loses access at the end of that day, even if their status has not been updated yet. People on leave keep their account.
  • People who left before the connection was made, and people who have not started yet, get no account.
  • A person with no work email, or whose email already belongs to an account that is not linked to this connection, is listed as not synced — by their Personio employee ID — and nobody else is held up.
  • If a sync would suddenly deactivate more than half of your people, it deactivates nobody and says why: that is almost always permissions that changed in Personio, not a mass layoff.

Personio's own guide: https://developer.personio.de/reference/authentication.