--- title: Personio synchronisieren description: Verbinde Personio Schritt für Schritt mit onyo, um Mitarbeitende automatisch zu synchronisieren --- [Zu Content springen](https://support.onyo.de/de/knowledge/personio-integration#main-content) - [Deutsch](https://support.onyo.de/de/knowledge/personio-integration) - [English](https://support.onyo.de/en/knowledge/personio-integration) Deutsch Untermenü für Übersetzungen anzeigen [Ticket erfassen](https://support.onyo.de/de/knowledge/kb-tickets/new?hsLang=de) ![logo\_green background.png\]](https://support.onyo.de/hs-fs/hubfs/logo_green%20background.png?width=40&height=40&name=logo_green%20background.png) - [Tickets](https://support.onyo.de/tickets-view) - [Wissensdatenbank](https://support.onyo.de/de/knowledge) - [Abmelden](https://25043582.hs-sites-eu1.com/_hcms/mem/logout) Hauptnavigation öffnen Hauptnavigation schließen - [Tickets](https://support.onyo.de/tickets-view) - [Wissensdatenbank](https://support.onyo.de/de/knowledge) - [Abmelden](https://25043582.hs-sites-eu1.com/_hcms/mem/logout) - - [Deutsch](https://support.onyo.de/de/knowledge/personio-integration) - [English](https://support.onyo.de/en/knowledge/personio-integration) Deutsch Untermenü für Übersetzungen anzeigen - [Ticket erfassen](https://support.onyo.de/de/knowledge/kb-tickets/new) - Zu onyo.io Zu onyo.io Hallo. Wie können wir dir helfen? - Es gibt keine Vorschläge, da das Suchfeld leer ist. 1. [onyo Wissensdatenbank](https://support.onyo.de/de/knowledge?hsLang=de) 2. [Manager:innen](https://support.onyo.de/de/knowledge/managerinnen?hsLang=de) 3. [Account & Set-Up](https://support.onyo.de/de/knowledge/managerinnen?hsLang=de#account-set-up) 5\. Oktober 2026 # Personio synchronisieren ## Verbinde Personio Schritt für Schritt mit onyo, um Mitarbeitende automatisch zu synchronisieren Mit der [HRIS-Synchronisierung](https://support.onyo.de/de/knowledge/hris-synchronisierung?hsLang=de) importiert onyo Deine Mitarbeitenden automatisch aus Personio – stündlich und ohne manuellen Import. Diese Anleitung führt Dich Schritt für Schritt durch die Einrichtung. **Voraussetzung:** In Personio brauchst Du die Zugriffsrechte für die **Marketplace-Integration** und die **API** (unter Einstellungen → Mitarbeiterrollen → Zugriffsrechte → Konto-Konfiguration) – eine volle Administrator-Rolle ist nicht nötig. **Du hast onyo bereits mit Personio verbunden?** Dann lege keine neue Integration an, sondern setze nur die Zugangsdaten zurück – siehe [Zugangsdaten zurücksetzen](https://support.onyo.de/de/knowledge/personio-integration#zugangsdaten-zuruecksetzen) am Ende dieses Artikels. ### Schritt 1: In onyo den Anbieter auf Personio setzen Öffne in onyo die [Seite HRIS-Synchronisierung](https://support-auth.onyo.de/api/hubspot/redirect?to=%2Fsettings%2Fgeneral%3Ftab%3Dhris_sync) (Einstellungen → Allgemeines → HRIS-Synchronisierung) und wähle unter **„HRIS-Anbieter“** den Eintrag **Personio** aus. ![onyo HRIS-Synchronisierung mit HRIS-Anbieter Personio und noch leeren Zugangsdaten](https://support.onyo.de/hs-fs/hubfs/2037-onyo-01-anbieter-personio.png?width=688&name=2037-onyo-01-anbieter-personio.png) ### Schritt 2: In Personio den onyo-Marketplace-Eintrag öffnen Öffne in Personio den **Marketplace** und suche nach **„onyo“**. Klicke auf die onyo-Kachel in den Suchergebnissen. ![Personio Marketplace, Suche nach onyo](https://support.onyo.de/hs-fs/hubfs/2037-personio-search-onyo-1.png?width=688&name=2037-personio-search-onyo-1.png) ### Schritt 3: Berechtigungen prüfen Öffne die onyo-Integration. Unter **„Einrichtung und Berechtigungen“** siehst Du, dass onyo nur die eine Berechtigung **„Daten zu Mitarbeitenden lesen“** benötigt. Du musst hier nichts manuell auswählen – die Berechtigung wird beim Verbinden automatisch erteilt. ![Personio, onyo-Integration, benötigte Berechtigung und synchronisierte Attribute](https://support.onyo.de/hs-fs/hubfs/2037-personio-02-einrichtung-berechtigungen-1.png?width=688&name=2037-personio-02-einrichtung-berechtigungen-1.png) ### Schritt 4: Verbinden und neue Zugangsdaten generieren Klicke oben rechts auf **„Verbinden“**. Wähle im nächsten Schritt **„Neue API-Zugriffsdaten generieren“** und bestätige. ![Personio, Auswahl Neue API-Zugriffsdaten generieren](https://support.onyo.de/hs-fs/hubfs/2037-personio-04-connect-select-credentials-1.png?width=688&name=2037-personio-04-connect-select-credentials-1.png) ### Schritt 5: Client-ID und Secret kopieren Personio erzeugt nun die Zugangsdaten: die **Client-ID** und das **Client secret**. Lass dieses Fenster geöffnet, bis beide Werte in onyo eingetragen sind (das Secret wird nur einmal angezeigt), und kopiere sie nacheinander hinüber – erst die Client-ID, dann das Secret (Schritt 6). ![Personio, generierte Client-ID und Client secret mit Kopier-Buttons](https://support.onyo.de/hs-fs/hubfs/2037-personio-05-neue-zugriffsdaten-1.png?width=688&name=2037-personio-05-neue-zugriffsdaten-1.png) ### Schritt 6: Zugangsdaten in onyo eintragen Wechsle zurück zu onyo und füge unter **„Verbinden“** die **Client-ID** in das Feld **„Personio Client-ID“** und das Secret in das Feld **„Personio API-Secret“** ein. Klicke anschließend auf **„Änderungen speichern“**. ![onyo Verbindung mit ausgefüllter Personio Client-ID und API-Secret](https://support.onyo.de/hs-fs/hubfs/2037-onyo-06-verbindung-personio.png?width=688&name=2037-onyo-06-verbindung-personio.png) ### Schritt 7: Synchronisierung einstellen Die Synchronisierungseinstellungen erscheinen erst, nachdem die Verbindung gespeichert wurde (die Gruppenliste wird live aus Personio geladen). Lege fest, welche Mitarbeitenden importiert werden: - **Beschäftigungsstatus** – nur Mitarbeitende mit diesen Status importieren. - **Beschäftigungsart** – nur Mitarbeitende mit diesen Beschäftigungsarten importieren. - **HRIS-Gruppen** – „HRIS-Gruppen“ ist der Sammelbegriff von onyo für **Abteilung**, **Team**, **Standort**, **Gesellschaft** und **Kostenstelle** aus Personio. Mit den **Mitarbeiterrollen** in Personio, die Zugriffsrechte steuern, hat das nichts zu tun. Leer lassen, um alle aktuellen und zukünftigen Gruppen zu importieren. Zur Auswahl stehen nur die Attribute, die onyo in Personio lesen darf: Ist die Liste leer oder fehlt z.B. die Kostenstelle, zeigt onyo unter „Verbinden“ den Hinweis „Einige optionale Mitarbeiterattribute sind nicht freigegeben“. Dann gehe in Personio zu **Einstellungen → „API-Zugriffsdaten“**, wähle **„onyo“** aus und ergänze die fehlenden Attribute bei den lesbaren Mitarbeiterattributen. - **Benutzerdefinierte Felder** – nur Mitarbeitende importieren, deren eigenes Feld in Personio einen bestimmten Wert hat, z.B. „onyo: ja“. Siehe [Zugriff über ein eigenes Feld in Personio steuern](https://support.onyo.de/de/knowledge/personio-integration#eigenes-feld) weiter unten. - **Budgetfeld in Tokens** – für die meisten Firmen irrelevant und nur relevant, wenn Ihr in onyo mit virtuellen Tokens statt Euro arbeitet. Nur dann und nur, wenn das Budget in Personio ebenfalls in Tokens gepflegt ist, aktivieren. **Wichtig:** Setzt Du mehrere Filter, müssen Mitarbeitende **alle** davon erfüllen, um importiert zu werden. Wählst Du z.B. bestimmte Beschäftigungsstatus **und** bestimmte Beschäftigungsarten aus, wird jemand nur importiert, wenn sowohl der Status als auch die Beschäftigungsart passt (und, falls Gruppen gewählt sind, die Person zu einer davon gehört, und, falls benutzerdefinierte Felder gewählt sind, jedes davon einen der angehakten Werte hat). Innerhalb eines einzelnen Filters genügt dagegen ein Treffer – etwa einer der ausgewählten Status. ![onyo Synchronisierungseinstellungen](https://support.onyo.de/hs-fs/hubfs/2037-onyo-08-sync-abgeschlossen.png?width=688&name=2037-onyo-08-sync-abgeschlossen.png) ### Schritt 8: Erste Synchronisierung starten Klicke auf **„Jetzt mit Personio synchronisieren“**, um den ersten Import zu starten. Danach synchronisiert onyo automatisch jede Stunde. Ein grünes **„Synchronisierung abgeschlossen“** bestätigt, dass alles funktioniert. Geschafft :) Ab jetzt hält onyo Deine Mitarbeitenden automatisch mit Personio in Einklang: Neue Personen werden in onyo angelegt, Änderungen (z.B. Name oder Adresse) übernommen und Personen, die nicht mehr Deinen Kriterien entsprechen oder in Personio gelöscht wurden, deaktiviert – stündlich und ohne manuellen Import. Solltest Du Fragen oder Probleme haben, wende Dich gerne jederzeit über das Kontaktformular an uns. --- ### Optional: Zugriff über ein eigenes Feld in Personio steuern Möchtest Du direkt in Personio pro Person festlegen, wer onyo nutzen darf, kannst Du dafür ein eigenes (benutzerdefiniertes) Feld verwenden – z.B. ein Feld **„onyo“** mit den Werten **„ja“** und **„nein“**. 1. Lege das Feld in den Personio-Einstellungen als neues Mitarbeiterattribut an, z.B. als Auswahl mit den Optionen „ja“ und „nein“. 2. Trage bei den Mitarbeitenden, die onyo nutzen sollen, **„ja“** ein. 3. Gib das Feld für onyo frei: Gehe in Personio zu **Einstellungen → „API-Zugriffsdaten“**, wähle **„onyo“** aus und ergänze das Feld bei den lesbaren Mitarbeiterattributen. Solange onyo auf kein eigenes Feld zugreifen darf, zeigt die Seite HRIS-Synchronisierung unter **„Benutzerdefinierte Felder“** den Hinweis **„onyo hat keinen Zugriff auf benutzerdefinierte Felder.“** 4. Wähle in onyo unter **„Benutzerdefinierte Felder“** → **„Nach Feld filtern…“** Dein Feld aus. onyo zeigt alle Werte des Felds und wie viele Personen in Personio den jeweiligen Wert haben. Hake die Werte an, die Zugriff auf onyo geben – Werte wie „ja“ sind bereits vorausgewählt. Klicke anschließend auf **„Änderungen speichern“**. **Wichtig:** Alle, die keinen der angehakten Werte haben – auch Personen, bei denen das Feld leer ist –, werden bei der nächsten Synchronisierung in onyo deaktiviert. Pflege das Feld in Personio deshalb, bevor Du den Filter speicherst. Hat aktuell niemand einen der angehakten Werte, weist onyo Dich darauf hin. Gibst Du das Feld später nicht mehr für onyo frei oder löschst es in Personio, synchronisiert onyo nicht mehr, statt alle Mitarbeitenden zu deaktivieren – bis Du das Feld wieder freigibst oder den Filter in onyo entfernst. --- ### Bereits verbunden? Zugangsdaten zurücksetzen Wenn Du die onyo-Integration in Personio bereits eingerichtet hast, lege **keine** neue Integration an. Setze stattdessen die bestehenden Zugangsdaten zurück: 1. Gehe in Personio zu **Einstellungen → „API-Zugriffsdaten“** und wähle **„onyo“** aus. 2. Öffne den Reiter **„API credentials“** und klicke auf **„Client-ID und API-Secret zurücksetzen“**, dann bestätige. 3. Trage die neue Client-ID und das neue API-Secret in onyo ein ([Schritte 6–8 oben](https://support.onyo.de/de/knowledge/personio-integration#schritt-6)). - [Manager:innen](https://support.onyo.de/de/knowledge/managerinnen?hsLang=de#main-content) - [Account & Set-Up](https://support.onyo.de/de/knowledge/managerinnen?hsLang=de#account-set-up) - [Bestell- und Versandprozess](https://support.onyo.de/de/knowledge/managerinnen?hsLang=de#bestell-und-versandprozess) - [Rücknahmeprozess](https://support.onyo.de/de/knowledge/managerinnen?hsLang=de#r%C3%BCcknahmeprozess) - [Vertragsverwaltung](https://support.onyo.de/de/knowledge/managerinnen?hsLang=de#vertragsverwaltung) - [Mitarbeiter:innen](https://support.onyo.de/de/knowledge/mitarbeiterinnen?hsLang=de#main-content) - [Lieferung und Montage](https://support.onyo.de/de/knowledge/mitarbeiterinnen?hsLang=de#lieferung-und-montage) - [Bestellung](https://support.onyo.de/de/knowledge/mitarbeiterinnen?hsLang=de#bestellung) - [Produktinformationen](https://support.onyo.de/de/knowledge/mitarbeiterinnen?hsLang=de#produktinformationen) - [Reklamation und Versicherungsfall](https://support.onyo.de/de/knowledge/mitarbeiterinnen?hsLang=de#reklamation-und-versicherungsfall) - [Sonstige](https://support.onyo.de/de/knowledge/mitarbeiterinnen?hsLang=de#sonstige) - [Rückgabe](https://support.onyo.de/de/knowledge/mitarbeiterinnen?hsLang=de#r%C3%BCckgabe) - [Allgemeines](https://support.onyo.de/de/knowledge/allgemeines?hsLang=de) [![Chill listening crop-3](https://support.onyo.de/hs-fs/hubfs/onyo_Logo_png.png?width=24&height=24&name=onyo_Logo_png.png "Chill listening crop-3")](https://www.onyo.io) onyo Wissensdatenbank Copyright © 2026, onyo GmbH