Cbox ID
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:
- In Personio, go to Settings → Integrations → API credentials and choose Generate new credentials. Name them "Cbox ID".
- Grant read access to persons and to org units (personio:persons:read, personio:org-units:read), and nothing that writes.
- 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.
Related
- Identity provider guides — every provider and HR system the portal guides you through.
- Directory Sync — the portal's directory setup.