Dieser Artikel behandelt häufig gestellte Fragen über Integrationen und APIs in Personio.

Pläne und Zugriff

Warum ist der Button Individuelle Integration erstellen in meinem Account nicht sichtbar?

Zum Erstellen individueller API Zugriffsdaten ist der Core Pro Plan erforderlich. Dabei handelt es sich um eine Einschränkung des Plans, kein Problem mit Zugriffsrechten. Mit einer Admin-Rolle erhalten Sie die richtigen Zugriffsrechte, aber keine Core Pro Funktionen. Wenn die Schaltfläche Individuelle Integration erstellen in Marketplace > Verbundene Integrationen nicht sichtbar ist, überprüfen Sie Ihren Plan unter Einstellungen > Account & Support > Abonnement & Abrechnung. Wenn Sie auf Core sind, müssen Sie ein Upgrade auf Core Pro durchführen, um auf diese Funktion zuzugreifen.

Ist für Marketplace-Integrationen der Core Pro Plan erforderlich?

Nein. Marketplace-Partnerintegrationen sind in allen Core Plänen verfügbar. Sie benötigen Core Pro nur, wenn Sie Ihre individuelle Integration über die Personio Public API erstellen möchten.

Kann ich ein KI-Tool wie Claude oder ChatGPT mit Personio verbinden?

Überprüfen Sie, ob das Tool, das Sie verbinden möchten, im Marketplace aufgeführt ist. Ist dies nicht der Fall, können Sie es trotzdem über die öffentliche API und Webhooks mit Personio verbinden. So können Sie Daten wie Mitarbeitendenprofile, Abwesenheiten, Anwesenheiten und Recruiting-Informationen austauschen. Für das Einrichten der Verbindung ist Ihre IT-Abteilung oder ein externes IT-Dienstleistungsunternehmen zuständig. Der Personio-Support kann Fragen zur API beantworten, Ihnen aber nicht dabei helfen, individuellen Code zu schreiben oder zu überprüfen.

Gibt es eine Sandbox- oder Testumgebung zum Entwickeln einer Personio API-Integration?

Personio bietet keine kostenlose Sandbox-Umgebung für die API-Entwicklung an. Im Rahmen unseres Premium Support-Plans steht eine spezielle Sandbox-Umgebung zur Verfügung.

Um API-Aufrufe zu testen, ohne echte Mitarbeitendendaten zu verwenden, erstellen Sie in Ihrem aktiven Account eine Reihe von Dummy-Mitarbeitendenprofilen mit fiktiven Namen und Daten. Verwenden Sie diese Profile, um Ihre API-Aufrufe zu testen und die Antworten zu beurteilen. Löschen oder anonymisieren Sie die Dummy-Profile, wenn Sie fertig sind.

Wozu dienen die API-Konfigurationen und die Berechtigungen für Mitarbeitendenrollen in der Marketplace-Integration?

Dies sind zwei separate Berechtigungen für Mitarbeitendenrollen:

• Marketplace-Integration: Einrichten und Verwalten von Drittanbieter-Integrationen im Personio Marketplace.
• API-Konfigurationen: Anzeigen und Verwalten von API-Zugriffsdaten, die für Marketplace- oder individuelle Integrationen von Drittanbietern verwendet werden.

Keine Rollenberechtigung steuert, welche Daten die API abrufen kann. Das hängt von den Zugriffsrechten der Integration selbst ab, nicht von der Mitarbeitendenrolle.

Eine Integration funktioniert nicht mehr – kann ich das Audit-Protokoll nutzen, um herauszufinden, was geändert wurde?

Nein. Das Audit-Protokoll erfasst keine Änderungen an Integrationen und verfolgt keine API-Aktivitäten. API-Aufrufe, die mit Zugriffsdaten einer Marketplace- oder individuellen Integration eines Drittanbieters durchgeführt werden, z. B. Datelese- oder -schreibvorgänge, erscheinen nicht im Audit-Protokoll. Erfahren Sie mehr über die Fehlerbehebung bei Integrationen und APIs.

Wie verwalte oder aktualisiere ich die Scopes meiner API-Zugriffsdaten?

Gehen Sie zu Marketplace > Verbundene Integrationen, um alle Ihre aktuellen Integrationen abzurufen, unabhängig davon, ob sie zu Marketplace- oder individuellen Integrationen gehören, die Sie selbst erstellt haben.

• Für mit Personio erstellte Integrationen gibt es feste Scopes, die nicht geändert werden können.
• Für Marketplace-Integrationen von Drittanbietern richtet Personio die korrekten Scopes ein, wenn Sie die Integration verbinden. Sie können diese zwar unter Marketplace > Verbundene Integrationen > Zugriffsrechte anzeigen und anpassen, sollten Sie aber nicht ändern müssen. Wenn etwas nicht mehr funktioniert, verbinden Sie die Integration erneut, anstatt die Scopes manuell anzupassen, da dies die korrekten Standardeinstellungen wiederherstellt.

Um eine neue Integration mit den zusätzlichen Leserechten zu erstellen, die Sie benötigen, zum Beispiel für Mitarbeitendenattribute, Anwesenheiten oder Abwesenheit, müssen Sie eine individuelle Integration erstellen. Dafür benötigen Sie den Core Pro-Plan. Im Core-Plan können Sie Marketplace-Integrationen verbinden, aber keine Scopes einer individuellen Integration erstellen oder bearbeiten.

Worauf kann mein IT-Team zugreifen, wenn ich ihm API-Zugriff gewähre?

Das hängt davon ab, wie Sie den Zugriff einrichten. Es gibt zwei Szenarien:

• Sie haben eine individuelle Integration erstellt und die Client-ID und den Clientschlüssel mit dem Team geteilt. Personen mit diesen Zugriffsdaten können nur auf die Daten zugreifen, die Sie für diese Zugriffsdaten aktiviert haben. Wenn Sie beispielsweise keinen Lesezugriff für Vergütungsattribute gewährt haben, können die betreffenden Personen diese nicht abrufen.
• Sie gaben ihnen Rollenberechtigungen für die Marketplace-Integration oder API-Konfigurationen gewährt. Diese Berechtigungen erlauben es Personen, API-Zugriffsdaten selbst zu erstellen oder zu verwalten, mit der Möglichkeit, sich selbst Zugriff auf fast alle Daten in Personio zu gewähren, darunter Gehälter und andere Vertrauliche HR-Informationen. Erfahren Sie mehr über die Rollenberechtigungen bei Integrationen.

Wenn die Zugriffsdaten Lesezugriff auf Berichte oder Individuelle Berichte haben und diese Berichte sensible Daten enthalten, können die Personen diese auch über die API abrufen. Für Berichte aus dem neuen Berichte-Builder müssen Sie jeden Bericht für den API-Zugriff aktivieren. Nur Berichte, die Sie aktivieren, können mit der API abgerufen werden. Die Aktivierung des Zugriffs auf individuelle Berichte gewährt Zugriff auf alle individuellen Berichte, und Sie können dies nicht für jeden einzelnen Bericht einschränken.

Um zu steuern, was Personen mit API-Zugriff abrufen können, überprüfen Sie, wer Bearbeitungsrechte für die Marketplace-Integration und API-Konfigurationen hat, und prüfen Sie die Scopes von vorhandenen API-Zugriffsdaten.

Verfügbarkeit von API-Daten und Abruflimits

Können API-Zugriffsdaten verwendet werden, um auf Daten zuzugreifen, die ein Mitarbeiter in der Personio Oberfläche nicht abrufen kann?

Ja. API-Zugriffsdaten funktionieren wie Zugriff auf Adminebene. Alle Personen mit Zugriff auf API-Zugriffsdaten können fast alle Daten aus dem Personio Account über die API abrufen, unabhängig von ihren Berechtigungen in Personio. Die Berechtigungen der Mitarbeitendenrolle gelten nur für die Schnittstelle. Sie beschränken nicht, was über die API abgerufen werden kann. Aus diesem Grund sollten Sie Zugriff auf API-Zugriffsdaten nur vertrauenswürdigen Personen gewähren.

Kann ich den API-Zugriff auf bestimmte Datentypen beschränken?

Ja. Wenn Sie eine individuelle Integration erstellen, wählen Sie aus, welche Datentypen sie abrufen kann. Wenn Sie nur Lesezugriff für einen bestimmten Datentyp aktivieren, kann die Integration nur Daten abrufen, die damit zusammenhängen. Zum Beispiel bedeutet Lesezugriff für Abwesenheit, dass die Integration nur Abwesenheitsdaten abrufen kann. Sie kann keine Mitarbeitenden, Dokumente, Gehälter oder andere Datentypen abrufen.

Kann ich mit der Personio API historische Gehaltsdaten abrufen?

Die Endpunkte der Personio API geben nur aktuelle Attributwerte zurück. Um historische Gehaltsdaten abzurufen, müssen Sie einen Bericht erstellen und über die API abrufen.

1. Navigieren Sie zu Analysen.
2. Klicken Sie auf Bericht erstellen und wählen Sie Leerer Bericht mit Änderungen an Mitarbeitenden. 
3. Fügen Sie die Gehaltsattribute hinzu, die Sie verfolgen möchten. Der Bericht enthält alte und neue Werte sowie das Wirksamkeitsdatum jeder Änderung.
4. Speichern Sie den Bericht.
5. Wählen Sie ihn in der Berichtsliste aus, klicken Sie auf API-Zugriff verwalten und wählen Sie Aktiviert.
6. Navigieren Sie zu Marketplace > Verbundene Integrationen.
7. Wählen Sie die entsprechende individuelle Integration und aktivieren Sie den Lesezugriff für Berichte.
8. Klicken Sie auf Aktualisieren.
9. Rufen Sie die Daten mit der API für Berichte v2 ab. Endpunkt: https://api.personio.de/v2/reports/attributes. 

Erfahren Sie mehr über die API für Berichte v2 und die API-Referenz zum Developer Hub.

Kann ich aktuelle Überstundenkonten für Mitarbeitende über die Personio API abrufen?

Nein. Es gibt keinen API-Endpunkt, der Überstundenkonten direkt zurückgibt. Um Überstundendaten programmatisch abzurufen, erstellen Sie einen Überstundenbericht in Analysen, und verwenden Sie die API für Berichte v2:

1. Navigieren Sie zu Analysen, und klicken Sie auf Bericht erstellen.
2. Wählen Sie Anwesenheiten, und wählen Sie einen Überstundenbericht in Tabellenform. 
3. Fügen Sie Mitarbeiter als Segment hin, und legen Sie Zu Summe berechnen fest.
4. Wählen Sie einen Datumsbereich, und speichern Sie den Bericht.
5. Befolgen Sie die Schritte, um den Bericht für API-Zugriff zu aktivieren und ihn mithilfe der API für Berichte v2 abzurufen.

Kann ich den Zugriff auf API-Zugriffsdaten auf bestimmte Vergütungsarten beschränken?

Nein. Berechtigungen für API-Zugriffsdaten werden auf Ressourcenebene gewährt. Wenn Sie einer individuellen Integration Zugriff auf die BerechtigungVergütungen gewähren, kann diese auf alle Vergütungsarten für alle Mitarbeitenden zugreifen. Sie können dies nicht auf eine bestimmte Art wie einmalige oder wiederkehrende Vergütung beschränken.

Es kann lediglich eine Beschränkung des Umfangs nach Gesellschaft erfolgen. Sie können auswählen, für welche Gesellschaften die Integration Vergütungsdaten abruft, was den Zugriff auf Mitarbeitende in diesen Gesellschaften einschränkt.

Wenn Sie verhindern möchten, dass die Integration auf andere Datentypen wie Mitarbeitendendaten oder Anwesenheiten zugreift, richten Sie eine eigene Integration ein, bei der nur die Berechtigung Vergütungen aktiviert ist. Diese Einschränkung regelt, welche Daten die Zugriffsdaten abrufen können, nicht welche Vergütungsarten der Vergütungs-API-Endpunkt zurückgibt. Die vollständige Liste abrufbarer und erstellbarer Vergütungsarten finden Sie in der Referenz zur Vergütungs-API im Developer Hub.

Welche Vergütungsarten gibt der Endpunkt GET /v2/compensations zurück?

Der Endpunkt gibt alle in Personio gespeicherten Vergütungsarten für den angeforderten Zeitraum zurück. Zu den zurückgegebenen Arten gehören:

• Grundgehalt (ohne anteilige Berechnung)
• Stundenlohn
• Einmalige Vergütung
• Wiederkehrende Vergütung
• Boni (außer Zielboni, die Sie nicht abrufen können)

Sie können Vergütungen auch mit POST /v2/compensations erstellen. Die unterstützten Arten für die Erstellung sind:

• Fixgehalt
• Stundenlohn
• Einmalige Vergütung
• Wiederkehrende Vergütung

Boni sind keine separate Art für die Erstellung. Ordnen Sie sie stattdessen als einmalige oder wiederkehrende Vergütung zu.

Um auf diesen Endpunkt zuzugreifen, aktivieren Sie Lesezugriff für Vergütungen in Ihrer individuellen Integration unter Marketplace > Verbundene Integrationen. Die vollständige Endpunkt-Dokumentation, einschließlich verfügbarer Filter und Anfrageparameter, finden Sie in der Referenz zur Vergütungs-API im Developer Hub.

Kann ich Arbeitszeitmodelle von Mitarbeitenden über die Personio API abrufen?

Ja. Arbeitszeitmodelle sind Teil der über die Mitarbeitenden-API v1 verfügbaren Mitarbeitendendaten. Um darauf zugreifen zu können, aktivieren Sie den Lesezugriff für Mitarbeitende in Ihrer Integration unter Marketplace > Vernetzte Integrationen. 

Sie können Arbeitszeitmodelle mit diesen Endpunkten abrufen:

• Alle Mitarbeitenden auflisten
• Bestimmten Mitarbeiter abrufen

Die API gibt das aktuelle Arbeitszeitmodell jedes Mitarbeiters zurück. Sie gibt keine historischen Daten zu Arbeitszeitmodellen zurück. Arbeitszeitmodelldaten mit täglicher Granularität sind in v2 nicht verfügbar. Verwenden Sie für diese Daten den v1-Endpunkt.

Warum werden Abteilung, Team und Position nicht in meiner API-Antwort angezeigt?

Abteilung, Team und Position sind beschäftigungsbezogene Attribute. Der Standard-Endpunkt für Mitarbeitendendaten gibt diese Informationen nicht zurück, selbst wenn Sie in Ihren API-Zugriffsdaten Lesezugriff für Mitarbeitende aktiviert haben. Um sie abzurufen, verwenden Sie stattdessen diese Endpunkte:

• Abteilung, Team und Position: GET /v2/persons/{person-id}/employments
• Übergeordnete Abteilungen: GET /v2/org-units

Der Organisationseinheiten-Endpunkt gibt nur Abteilungen der obersten Ebene (übergeordnet) zurück. Dieser Endpunkt gibt keine Unterabteilungen innerhalb einer Abteilungshierarchie zurück.

Für Attribute wie Geburtsdatum, die in der Standardantwort zu Mitarbeitenden angezeigt werden, müssen Sie keine Änderungen vornehmen.

Wie rufe ich Stellenkatalogdaten (Stellenbezeichnung, Stellenfamilie und Stellenebene) mit der Personio API ab?

Stellenkatalogattribute sind mit der Personio API verfügbar. Verwenden Sie diese Endpunkte:

• Alle Stellen auflisten: GET /v2/jobs
• Eine einzelne Stelle abrufen: GET /v2/jobs/{id}

Um den Zugriff einzurichten, öffnen Sie Ihre individuelle Integration, und aktivieren Sie den Zugriff für den Stellenkatalog. Um Daten über Gehaltsbänder einzubeziehen, sollte auch der Zugriff für Gehaltsbänder aktiviert werden.

Mehr über die Endpunktdokumentation erfahren Sie im Developer Hub.

Kann ich die Unterattribute des Attributs Kind über die Personio API abrufen?

Nein. Unterattribute des Attributs Kind, wie erwartetes Fälligkeitsdatum und Geburtsdatum des Kindes, sind mit der Personio API (v1 oder v2) nicht verfügbar. Dies gilt sowohl für den direkten API-Zugriff als auch für Berichte, die mit der API exportiert werden.

Wie rufe ich mit der Personio API Abwesenheitsdaten für alle Mitarbeitenden ab?

Verwenden Sie den Endpunkt GET /v2/absence-periods, um Abwesenheitszeiträume, einschließlich aller Abwesenheitsarten und deren Daten, für Ihre Mitarbeitenden abzurufen.

So können Sie das einrichten:

1. Gehen Sie zu Marketplace > Verbundene Integrationen.
2. Wählen Sie Ihre individuelle Integration aus, und aktivieren Sie Lesezugriff für Abwesenheit.
3. Rufen Sie den Endpunkt GET /v2/absence-periods auf. Sie können nach Mitarbeitenden, Abwesenheitsart oder Datumsbereich filtern.

Besuchen Sie den Developer Hub für die vollständige Endpunktdokumentation und verfügbare Filter.

Kann ich mit der Personio API Vertretungsdaten für Abwesenheiten abrufen?

Nein. Vertretungsdaten sind mit der Personio API nicht verfügbar. Sie können eine Vertretung angeben, wenn Sie eine Abwesenheit über die API erstellen, aber der Endpunkt GET /v2/absence-periods gibt das Feld Vertretung nicht zurück. Es steht kein Endpunkt zum Abrufen von Vertretungsdaten zur Verfügung.

Wie synchronisiere ich Projekte aus einem externen Tool in Personio mit der API zur projektbasierten Zeiterfassung?

Sie können Projekte in zwei Schritten synchronisieren:

1. In Personio erstellen Sie zuerst die Projekte. Verwenden Sie den Projekt-API-Endpunkt, um die einzelnen Projekte zu erstellen. Fügen Sie eine Projekt-ID hinzu, die mit der Kennung in Ihrem externen Tool übereinstimmt.
2. Übermitteln Sie Zeiteinträge, die mit diesen Projekten verknüpft sind. Sobald die Projekte in Personio existieren, verwenden Sie den Anwesenheits-API-Endpunkt, um Anwesenheitsdatensätze zu übermitteln. Fügen Sie in jedem Eintrag die Projekt-ID hinzu. Das verknüpft die erfasste Zeit zur projektbezogenen Zeiterfassung mit dem richtigen Projekt.

Um auf den Projektendpunkt zuzugreifen, aktivieren Sie in Ihren API-Zugriffsdaten den Zugriff auf Anwesenheiten (Lesezugriff, Schreibzugriff oder beides). Es gibt keine separate Berechtigung für Projekte. Erfahren Sie mehr über die Endpunktdokumentation.

Warum finde ich keine Projekt-Option in den API-Zugriffsdateneinstellungen meiner individuellen Integration?

Um den Projekt-API-Endpunkt in einer individuellen Integration aufzurufen, müssen Sie den Zugriff auf Anwesenheiten (Lese- und/oder Schreibzugriff) in Ihren API-Zugriffsdaten aktivieren. Es gibt keine separate Berechtigung für Projekte. Der Projekt-API-Endpunkt ist durch den Zugriff auf Anwesenheiten abgedeckt.

Beschränkt Personio den API-Zugriff basierend auf IP-Adressen?

Nein. Personio schränkt oder blockiert API-Zugriff nicht basierend auf IP-Adressen. Wenn Ihre API-Aufrufe fehlschlagen, liegt das Problem im Anfrageformat oder in den Zugriffsdaten.

Wiederholte fehlgeschlagene Login-Versuche von derselben IP-Adresse können dazu führen, dass die IP vom Personio Login blockiert wird. Dies ist ein separates System und betrifft nicht den API-Zugriff.

Gibt es Ratenbegrenzungen für API-Aufrufe?

Ja. API-Ratenbegrenzungen variieren je nach Endpunkt. Die globale Obergrenze für v1-Endpunkte beträgt 2.000 Anfragen pro Minute. Die Standard-Ratenbegrenzung für v2-Endpunkte beträgt 30 Anfragen pro Sekunde (1.800 Anfragen pro Minute), wobei einzelne Endpunkte höhere oder niedrigere Obergrenzen haben können. Es gibt zudem eine globale Infrastrukturobergrenze von 2.000 Anfragen pro Minute. Dies ist ein Höchstwert für alle Anfragen, keine Garantie pro Endpunkt.

Ratenbegrenzungen für bestimmte Endpunkte:

• /v1/auth: 60 Anfragen pro Minute. Eine Überschreitung triggert eine 60-sekündige Abklingzeit.
• /v2/auth/token: 150 Anfragen pro Minute. Bei Überschreitung ist für die nächsten 60 Sekunden nur 1 Anfrage pro Sekunde erlaubt, dann wird der Wert zurückgesetzt.
• GET Employees (v1): 300 Anfragen pro Minute, mit einer Spitzenrate von 15 Anfragen pro Sekunde.
• Recruiting (Bewerbungen und Dokumente): 20 Anfragen pro 60 Sekunden pro Unternehmen. Nach Erreichen der Obergrenze müssen Sie 60 Sekunden warten, bevor Sie weitere senden.

Wenn hier keine Ratenbegrenzung aufgeführt ist, gehen Sie davon aus, dass der Standardwert von v2 von 30 Anfragen pro Sekunde (1.800 Anfragen pro Minute) gilt, und implementieren Sie einen Wiederholungsmechanismus mit mindestens einer Sekunde Verzögerung, wenn Sie eine 429-Antwort (Zu viele Anfragen) erhalten.

Datenimport und Berichte

Kann ich Datenimporte in Personio durchführen, ohne die API zu verwenden?

Ja. Sie können Daten importieren, indem Sie die in Personio integrierten Vorlagen importieren – dafür sind keine API und kein Entwicklungsaufwand erforderlich. Unterstützt werden Daten zu Mitarbeitenden, Anwesenheiten, Abwesenheit und Gehalt.

Kann ich automatische Berichte für Ereignisse im Mitarbeitendenlebenszyklus wie Neuanstellungen, Austritte und Anwesenheitsänderungen einrichten?

Sie können das automatische Senden von Berichten nicht direkt in Personio planen. Es gibt keine integrierte Funktion, die Berichte in einer festgelegten Häufigkeit sendet oder den Export eines Berichts für ein Lebenszyklusereignis auslöst. Um diese Daten zu verfolgen, gehen Sie zu Analysen > Metriken oder Analysen > Berichte, und führen Sie Berichte manuell aus. Dort finden Sie viele vordefinierte Berichtsvorlagen. Wenn Sie programmatischen Zugriff auf Berichtsdaten benötigen, können Sie Berichte mit der API für Berichte v2 abrufen. Sie können dann Ihren eigenen Ablauf extern erstellen.

Marketplace-Integrationen

Warum zeigt eine verbundene Integration immer noch einen alten Wert an, nachdem ich eine Attributoption umbenannt habe?

Das Umbenennen einer Option in einem Auswahllistenattribut aktualisiert nur das Anzeigelabel in Personio. Der Datenbankwert, den Personio an verbundene Integrationen sendet, bleibt gleich, und Sie können ihn nicht ändern. Um den Wert zu aktualisieren, den Ihre Integration erhält, erstellen Sie eine neue Option mit dem richtigen Namen. Der Name, den Sie zuerst eingeben, wird zum neuen Datenbankwert. Erfahren Sie mehr über das Beheben von Datenbankwerten und Anzeigelabels.

Warum verbleibt meine Marketplace-Integration im Status Ausstehend?

Der Status Ausstehend bedeutet, dass Personio bereit ist und darauf wartet, dass die Integration die erste API-Anfrage stellt. Der Status ändert sich automatisch zu Verbunden, sobald die Integration Daten sendet. Sie können ihn nicht manuell aktualisieren. 

Wenn Ihre Integration Ausstehend anzeigt, überprüfen Sie zuerst die Konfiguration im externen System, um sicherzustellen, dass sie aktiv Anfragen an Personio sendet. Sie können überprüfen, auf welche Daten die Integration in Personio zugreifen kann, indem Sie zu Marketplace > Verbundene Integrationen gehen, auf die Integration klicken und den Reiter Zugriffsrechte auswählen. Das externe System und nicht Personio steuert das Verhalten der Integration.

Wenn der Status Ihrer Integration über einen längeren Zeitraum Ausstehend lautet, liegt ein Problem beim Partner vor. Personio hat keinen Einblick, wie Drittunternehmen Integrationen entwickeln oder warum sie keine Daten senden. Wenn das Partnertool die Integration auf Partnerseite als aktiv anzeigt, beheben Sie das Problem, bevor Sie den Partner kontaktieren. Die Ursache kann eine fehlende Übereinstimmung der Zugriffsdaten sein, die Sie selbst beheben können. Kontaktieren Sie für eine Untersuchung das Support-Team des Partners, nicht Personio.

Warum meldet meine Marketplace-Integration fehlende API-Berechtigungen, und wie behebe ich das?

Um fehlende API-Berechtigungen bei einer Marketplace-Integration zu beheben, trennen und verbinden Sie diese erneut:

1. Gehen Sie zu Marketplace > Verbundene Integrationen.
2. Wählen Sie die Integration aus.
3. Klicken Sie auf Trennen.
4. Gehen Sie zum Marketplace und suchen Sie nach der Integration.
5. Klicken Sie auf Verbinden.
6. Klicken Sie auf Neue Zugriffsdaten generieren, um automatisch neue API-Zugriffsdaten mit den Berechtigungen zu generieren, die die Integration benötigt.

Wenn die Integration nach der erneuten Verbindung weiterhin nicht wie erwartet funktioniert, wenden Sie sich für Unterstützung an das Support-Team des Integrationspartners.

Kann ich mehrere Integrationen gleichzeitig ausführen?

Ja. Die Personio API reagiert auf Anfragen von verbundenen Tools, anstatt sie zu initiieren. Das bedeutet, dass das gleichzeitige Ausführen mehrerer Integrationen standardmäßig keinen Konflikt verursacht. Ausnahme ist, wenn zwei Integrationen gleichzeitig Schreibzugriff auf denselben Datentyp haben, beispielsweise auf Anwesenheiten. Wenn beide dieselben Datensätze hinzufügen oder aktualisieren, kann dies zu widersprüchlichen Daten oder Überschreibungen führen. Wenn Sie mehrere Integrationen für dieselben Daten ausführen, überprüfen Sie, ob mehrere Schreibzugriff darauf haben. Stimmen Sie sich bei Bedarf mit allen Partnern ab.

Kann ich einen zweiten Account mit einer bereits genutzten Marketplace-Integration verbinden?

Sie können die vorhandenen Zugriffsdaten verwenden, um einen zweiten Account mit derselben Integration zu verbinden. Sie können jedoch keinen zweiten Satz an API-Zugriffsdaten für dieselbe Marketplace-Integration erstellen. Bei Verwendung einer Marketplace-Integration oder Verbindung einer Integration über die öffentliche API fallen bei Personio keine zusätzlichen Kosten an, sofern für Ihren Account der Core Pro-Plan gilt, der die API-Nutzung beinhaltet. Einige Partnertools haben möglicherweise eigene Preise. Fragen Sie direkt beim Partner nach, wenn Sie unsicher sind.

Kann ich bestimmte Mitarbeitende von einer Marketplace-Integration ausschließen?

Bei den meisten Marketplace-Integrationen gibt es keine Option, einzelne Mitarbeitende oder eine bestimmte Gruppe auszuschließen. Alle Mitarbeitenden werden standardmäßig synchronisiert. Einige Payroll-Integrationen wie Xero, ADDISON und Loket bilden eine Ausnahme. Sie enthalten ein Attribut, mit dem Sie einzelne Mitarbeitende von dieser spezifischen Lohnbuchhaltung ausschließen können. Wenn es sich nicht um eine Payroll-Integration handelt, ist diese Funktion nicht verfügbar.

Einige Integrationen bieten die Filterung innerhalb ihrer eigenen Einstellungen. Dies ändert jedoch in der Regel nur, wie das Partner-Tool Mitarbeitende anzeigt – die Datenübertragung in dieses Tool erfolgt trotzdem. Filteroptionen für die einzelnen Integrationen finden Sie in der Dokumentation des Partners.

Was passiert, wenn ich eine Integration beantrage, die nicht im Marketplace enthalten ist?

Sie erhalten keine individuelle Bestätigung oder Statusaktualisierung per E-Mail, nachdem Sie eine Integration beantragt haben. Um den Fortschritt zu überprüfen, besuchen Sie die Seite mit den beantragten Integrationen. Wenn Personio beschließt, die Integration zu erstellen, wird der Status dort aktualisiert.

Warum wird meine Integration in verbundenen Integrationen ohne Logo angezeigt?

Wenn eine Marketplace-Integration unter Marketplace > Verbundene Integrationen ohne Logo angezeigt wird, bedeutet dies, dass Sie die Integration einrichten, indem Sie API-Zugriffsdaten manuell erstellen, anstatt im Marketplace auf Verbinden zu klicken. Dadurch wird ein individueller Eintrag für Zugriffsdaten anstelle eines Eintrags für Marketplace-Integrationen erstellt. Deshalb wird die Integration ohne Logo angezeigt. Personio empfängt mit Ihren individuellen Zugriffsdaten weiterhin Daten aus dem Partnertool, die Integration wird jedoch nicht offiziell mit dem Marketplace-Eintrag verknüpft.

Dies bedeutet, dass der Partner möglicherweise nicht automatisch Aktualisierungen von Zugriffsdaten oder Authentifizierungen für Sie verwaltet. Um die offizielle Marketplace-Version zu verwenden, in der der Partner die Integration verwaltet, heben Sie die Verbindung mit dem individuellen Eintrag auf und verbinden Sie ihn erneut über den Marketplace, indem Sie auf der Seite der Integration auf Verbinden klicken. Wenn die Integration funktioniert und Sie sie nicht neu konfigurieren möchten, wenden Sie sich direkt an das Support-Team des Partners, um zu bestätigen, dass er die erforderlichen Updates auf seiner Seite vornimmt.

Warum synchronisiert meine Marketplace-Integration nicht alle Datentypen?

Der Partner entscheidet, welche Datentypen seine Integration synchronisiert, nicht Personio. Die Daten sind in Personio verfügbar, aber die Integration des Partners steuert, was er abfragt und sendet. Wenn eine Integration einen Datentyp, den Sie erwarten, nicht synchronisiert, ist das normalerweise eine Implementierungsentscheidung des Partners. Es ist kein Fehler, der sich beheben lässt. Um weitere Datentypen anzufragen oder sich über teilweise Synchronisierung zu erkundigen, wenden Sie sich bitte direkt an den Partner.

Wie authentifiziere ich eine bestehende Marketplace-Integration erneut?

Wenn eine Marketplace-Integration ihre Verbindung verliert oder Sie die Authentifizierung nach einer Änderung an Zugangsdaten oder der API aktualisieren müssen, ist keine neue Einrichtung erforderlich.

1. Gehen Sie zu Marketplace > Verbundene Integrationen und wählen Sie die Integration aus.
2. Klicken Sie neben Authentifizierung wiederholen auf Weiter.
3. Befolgen Sie die Schritte, um die Autorisierung im Partnersystem abzuschließen.
4. Wenn Sie dazu aufgefordert werden, prüfen Sie, ob die Feldzuordnung weiterhin korrekt ist.

Wenn die erneute Authentifizierung nicht erfolgreich abgeschlossen wird, erscheint in der Integration eine Warnmeldung. Folgen Sie der Aufforderung, um die Verbindung wiederherzustellen.

Kann ich eine bidirektionale Synchronisierung aktivieren, damit Daten von einer Drittanbieter-Integration an Personio zurückgegeben werden?

Die öffentliche API von Personio kann Daten zu Mitarbeitenden, Abwesenheit, Anwesenheiten und Recruiting aus externen Systemen empfangen. Marketplace-Partnerintegrationen synchronisieren Daten jedoch oft nur in eine Richtung – in der Regel von Personio zum Partner. Das hängt von der Art und Weise ab, wie der Partner die Integration erstellt hat, nicht von Ihren Berechtigungen. 

Personio besitzt oder kontrolliert den Integrationscode des Partners nicht. Dies bedeutet, dass wir keine bidirektionale Synchronisierung mit einer Integration hinzufügen können, die der Partner nicht unterstützt.

Wenn die Integration im Marketplace aufgelistet wird, überprüfen Sie sie auf detaillierte Angaben dazu, welche Daten sie synchronisiert. Gehen Sie nicht davon aus, dass alle Funktionen einer Integration auf dem Marketplace aufgeführt sind – Einträge beschreiben möglicherweise nicht das vollständige Synchronisierungsverhalten. Fragen Sie direkt beim Partner nach, was die Integration tatsächlich unterstützt. Daten können auch an Personio zurückgegeben werden. Dazu muss der Partner oder Ihr IT-Team die Funktion mithilfe der Personio API erstellten. Wenn Sie unsicher sind, was eine bestimmte Integration unterstützt, wenden Sie sich direkt an den Partner.

Warum finde ich beim Verbinden einer Integration das Attribut „Arbeitsort“ nicht?

Einige Drittanbieter-Integrationen bezeichnen das Attribut Standort von Personio als „Arbeitsort“. Gemeint ist dasselbe – der physische Standort des Mitarbeiters. Wenn eine Integration ein Attribut „Arbeitsort“ erfordert und Sie es nicht finden können, überprüfen Sie, ob Sie Standorte in Personio eingerichtet haben:

1. Gehen Sie zu Einstellungen.
2. Klicken Sie im Abschnitt Unternehmen auf Standorte.
3. Fügen Sie einen Standort hinzu, wenn keiner vorhanden ist, oder überprüfen Sie, ob Sie vorhandene Standorte eingerichtet haben.
4. Sobald Sie einen Standort eingerichtet haben, wird das Attribut Standort in den Mitarbeitendenprofilen verfügbar. Die Integration kann dann die entsprechende Zuordnung vornehmen.

Warum werden meine Abwesenheitsdaten nicht synchronisiert, obwohl eine Drittanbieter-Integration als verbunden angezeigt wird?

Personio stellt eine REST-API bereit, was bedeutet, dass es Daten nicht proaktiv an verbundene Tools sendet. Eine Drittanbieter-Integration muss die benötigten Daten aktiv anfordern (ziehen). Beispielsweise muss sie Abwesenheitszeiträume abfragen, nachdem jemand sie genehmigt hat. Personio hat keinen Einblick, ob ein Drittanbieter-Tool diese Anfrage gestellt oder warum sie das unterlassen hat.

1. Stellen Sie sicher, dass die für die Integration eingerichteten API-Zugriffsdaten Lesezugriff für die relevanten Daten enthalten (z. B. Abwesenheit).
2. Wenden Sie sich an das Support-Team der Integration und bitten Sie es, ihre Protokolle auf die betroffenen Datensätze zu überprüfen.
3. Das Team kann prüfen, ob ihr System die Daten von Personio angefordert hat und welche Daten Personio zurückgegeben hat.

Nutzende können sich nicht mehr in eine Drittanbieter- oder individuellen Integration einloggen – hat sich etwas an der Personio Verbindung geändert?

Personio hat keinen Einblick in Änderungen, die an von Dritten entwickelten Marketplace- oder individuellen Integrationen vorgenommen wurden. Wenn das Problem weiterhin besteht, kontaktieren Sie das Support-Team des Partners für eine von Dritten entwickelte Marketplace-Integration oder Ihr IT-Team für eine individuelle Integration.

Wenn Nutzende sich nicht in Personio selbst einloggen können, ist das ein separates Problem. Erfahren Sie mehr über die Fehlerbehebung bei SSO-Login-Problemen.

Was ist der Unterschied zwischen dem Deaktivieren und dem Trennen einer Integration, und wann sollte ich welche Option verwenden?

Das Deaktivieren einer Marketplace- oder individuellen Integration macht die Integration inaktiv, behält sie aber in Marketplace > Verbundene Integrationen bei. Die Trennung einer Marketplace- oder individuellen Integration löscht die Zugriffsdaten dauerhaft und kann nicht rückgängig gemacht werden. Sie können eine von Personio erstellte Integration nicht deaktivieren.

Wenn Sie sich nicht sicher sind, ob eine Integration noch verwendet wird, deaktivieren Sie die Integration zunächst. Wenn dies keine Probleme verursacht, können Sie sie anschließen trennen, um sie dauerhaft zu entfernen.

Um eine Marketplace-Integration oder individuelle Integration eines Drittanbieters zu deaktivieren oder zu trennen:

1. Gehen Sie zu Marketplace > Verbundene Integrationen.
2. Klicken Sie in der Spalte Aktion auf die drei Punkte neben der Integration.
3. Klicken Sie auf Deaktivieren oder Trennen.

Was sind meine Optionen, wenn ein Tool, das ich verbinden möchte, nicht im Marketplace vorhanden ist?

Wenn Sie HR-Daten analysieren oder entsprechende Berichte erstellen möchten, sollten Sie überprüfen, ob der integrierte Analysebereich von Personio bereits Ihren Anforderungen entspricht. Es beinhaltet Metriken, KPIs und ermöglicht das Erstellen individueller Berichte.

Wenn das Tool, das Sie benötigen – zum Beispiel ein Business-Intelligence (BI)- oder Analysetool wie Power BI oder Tableau –, nicht im Personio Marketplace aufgeführt ist, haben Sie zwei Optionen, abhängig davon, was Sie benötigen.

Wenn das Tool, das Sie suchen – zum Beispiel ein Business-Intelligence-(BI)- oder Analysen wie Power BI oder Tableau – nicht im Personio Marketplace aufgeführt ist, haben Sie zwei Optionen, abhängig davon, was Sie benötigen.

• Verwenden Sie eine Integrationsplattform: Integrationsplattformen wie Zapier können Personio mit vielen anderen Apps ohne individuelle Entwicklung verbinden. Dies funktioniert am besten für Workflow-Automatisierungen, zum Beispiel das Triggern einer Aktion in einem anderen Tool, wenn sich etwas in Personio ändert. Zapier ist als Marketplace-Integration verfügbar.
• Erstellen Sie eine individuelle Integration mit der Personio API: Wenn eine Integrationsplattform nicht Ihre Anforderungen erfüllt, können Sie eine individuelle Integration mithilfe der Personio API erstellen. Dafür benötigen Sie den Core Pro-Plan. Ihr IT-Team oder ein externer IT-Anbieter ist für den Aufbau der Verbindung verantwortlich. Der Personio Support kann Fragen zur API beantworten, Ihnen aber nicht dabei helfen, individuellen Code zu schreiben oder zu überprüfen.

Warum landen Dokumente, die von einer Drittanbieter-Integration hochgeladen werden, in der falschen Kategorie, und wie behebe ich das?

Wenn eine Drittanbieter-Integration Dokumente über die API in Personio hochlädt, bestimmt die Kategorie-ID in der API-Anfrage die Dokumentenkategorie. Wenn Dokumente in der falschen Kategorie landen, verwendet die Integration eine falsche Kategorie-ID.

Um die korrekten Kategorie-IDs zu finden, rufen Sie den Endpunkt der Dokumentenkategorien auf: GET /v1/company/document-categories

Dies gibt eine Liste aller verfügbaren Dokumentenkategorien und deren IDs zurück. Ihre API-Zugriffsdaten benötigen Lesezugriff auf Dokumente, damit dieser Endpunkt funktioniert. Sobald Sie die korrekte Kategorie-ID kennen, ergeben Sie diese beim Hochladen des Dokuments in die Anfrage POST /v1/company/documents ein, um es der richtigen Kategorie zuweisen.

Teilen Sie die korrekte Kategorie-ID mit dem Integrationsanbieter, damit dieser die Kategoriezuordnung auf seiner Seite aktualisieren kann.

Individuelle Integrationen

Wie kann ich herausfinden, wofür eine nicht identifizierte individuelle Integration in meinem Account verwendet wird?

Personio speichert den Zweck einer individuellen Integration nicht, sondern empfängt nur API-Anfragen. So untersuchen Sie eine unbekannte Integration:

1. Gehen Sie zu Marketplace > Verbundene Integrationen, wählen Sie die Integration aus, und überprüfen Sie deren API-Berechtigungen, um festzustellen, auf welche Daten sie zugreifen kann – zum Beispiel Mitarbeitende, Anwesenheiten oder Abwesenheit.
2. Prüfen Sie intern, ob andere in Ihrem Unternehmen wissen, womit die Integration verbunden ist. Sie könnten dazu Ihr IT-Team fragen, interne Dokumentationen zu Ihrem Technologie-Stack lesen oder die Person kontaktieren, die die Integration ursprünglich eingerichtet oder zuvor verwaltet hat.
3. Wenn Sie dennoch keine Antwort finden, deaktivieren Sie sie vorübergehend, und beobachten Sie, ob Probleme in Ihren Systemen auftreten. Wenn dies keine Probleme verursacht, können Sie sie anschließen trennen.

Warum wird meine neue individuelle Integration als ausstehend angezeigt?

Wenn Sie eine individuelle Integration in Personio erstellen, wird der Status zunächst als Ausstehend angezeigt. Das bedeutet, Personio ist bereit, Anfragen entgegenzunehmen – Sie müssen in Personio nichts weiter tun. Der Status ändert sich automatisch zu Verbunden, sobald Ihre Integration ihren ersten erfolgreichen API-Aufruf tätigt.

Wenn die Integration immer noch Ausstehend anzeigt, wurde die Verbindung auf Ihrer Seite noch nicht hergestellt. Überprüfen Sie, ob Ihr System die für die Integration generierte Client-ID und den Clientschlüssel korrekt verwendet. Wenn Sie einen fehlgeschlagenen API-Aufruf beheben müssen, überprüfen Sie die vollständige Anfrage (einschließlich Header und Text), die verwendete Client-ID und die vollständige API-Antwort, um das Problem zu identifizieren.

Slack und Microsoft Teams

Kann ich verhindern, dass Slack oder Microsoft Teams den Geburtstag oder Jahrestag der Betriebszugehörigkeit von Mitarbeitenden bekannt gibt?

Nein. Kanalaktualisierungen gelten für alle in der Abteilung, im Team oder am Standort, die diesem Kanal zugeordnet sind – Sie können keine einzelnen Mitarbeitenden ausschließen. Sie haben zwei Möglichkeiten: Deaktivieren Sie diesen Ereignistyp für den gesamten Kanal, oder grenzen Sie die Abteilung, das Team oder den Standort, dem Sie die Aktualisierung zuweisen, enger ein, sodass der Mitarbeiter nicht einbezogen wird.

Kanalaktualisierungen sind davon abhängig, ob der Status einer Mitarbeiterin oder eines Mitarbeiters in Personio aktiv oder inaktiv ist, nicht vom Status der Auszeit. Mitarbeitende in Auszeit oder einer anderen Abwesenheitsart zählen weiterhin als aktiv und erscheint weiterhin in Aktualisierungen. Sie können Aktualisierungen nicht nach Abwesenheitsart filtern. Eine bestimmte Person kann nur ausgeschlossen werden, wenn sie in Personio als inaktiv markiert wird.

Kann die Microsoft Teams-Integration in ihren täglichen Updates Standorttypen wie „Homeoffice“ oder „Geschäftsreise“ berücksichtigen?

Nein. Die Teams-Integration sendet nur tägliche Kanal-Updates für eine bestimmte Auswahl an Ereignissen: Abwesenheiten und Rückkehrtermine von Mitarbeitenden, Geburtstage, Arbeitsjubiläen und neue Mitarbeitende. Sie erfasst keine Anwesenheits- oder Standorttypen wie Homeoffice, mobiles Arbeiten oder Geschäftsreisen.

Wenn Sie möchten, dass Teammitglieder sehen können, wer im Homeoffice oder auf Geschäftsreise ist, benötigen Sie eine benutzerdefinierte Integration über die API: Verwenden Sie die Personio API, um Daten zum Arbeitsort und zu Abwesenheiten abzurufen, und erstellen Sie eine individuelle Integration, die diese Informationen in einem Teams-Kanal oder nach einem Zeitplan veröffentlicht. Das erfordert Entwicklungsarbeit durch Ihr IT-Team oder einen externen Anbieter.

Kann ich bestimmte Abwesenheitsarten, wie Mutterschutz oder Elternzeit, von der täglichen Abwesenheitsaktualisierung auf Slack ausnehmen?

Nein. Wenn eine Aktualisierung Abwesenheiten enthält, beinhaltet sie alle Abwesenheitsarten. Sie können nicht nach Typ filtern. Sie können eingrenzen, für wen die Aktualisierung gilt, indem Sie sie einer bestimmten Abteilung, einem Team oder einem Standort zuweisen. Das ändert jedoch die Zielgruppe und nicht, welche Abwesenheitsarten angezeigt werden.

Kann ich mehr als einen Slack-Workspace mit meinem Personio Account verbinden?

Nein, Sie können nur einen Slack-Workspace pro Personio Account verbinden. Wenn Sie eine zweite Gesellschaft mit einem separaten Slack-Workspace haben, können Sie die Personio API als Abhilfe verwenden, um Abwesenheitsbenachrichtigungen an diesen Workspace zu senden. Gehen Sie hierzu wie folgt vor:

1. Verwenden Sie den Endpunkt Mitarbeitende auflisten, um Mitarbeitende abzurufen und nach Gesellschaft zu filtern.
2. Verwenden Sie den Endpunkt Abwesenheitszeiträume auflisten, um Abwesenheiten für diese Mitarbeitenden abzurufen.
3. Verwenden Sie die Slack API, um die Ergebnisse in einen Kanal im zusätzlichen Workspace zu veröffentlichen.

Weitere Informationen dazu finden Sie unter API-Zugriff und in der Endpoint-Dokumentation im Developer Hub.

Kann ich Slack so konfigurieren, dass halbtägige oder stündliche Abwesenheiten genau angezeigt werden?

Nein. Die automatische Funktion für den Slack-Status unterstützt nur ganztägige Abwesenheiten. Halbtägige und stündliche Abwesenheiten werden in Slack als ganztägige Abwesenheiten angezeigt. Es gibt keine Einstellung, um das zu ändern. Die Abwesenheitsdaten in Personio bleiben genau. Diese Einschränkung betrifft nur die Anzeige des Slack-Status. 

Wenn halbtägige Abwesenheiten in Slack dargestellt werden sollen, können Sie eine individuelle Lösung entwickeln. Sie verwenden hierzu Personio-Webhooks und API-Endpunkte um Slack-Statusaktualisierungen basierend auf bestimmten Abwesenheitsdaten auszulösen. Für das Einrichten der Verbindung ist Ihre IT-Abteilung oder ein externes IT-Dienstleistungsunternehmen zuständig. Der Personio-Support kann Fragen zur API beantworten, Ihnen aber nicht dabei helfen, individuellen Code zu schreiben oder zu überprüfen.

Was sind Partner-ID und App-ID, und brauche ich sie?

Die Partner-ID und die App-ID sind Header, die Sie in API-Anfragen von Personio angeben können, um Ihre Integration zu identifizieren. Sie legen diese Werte selbst fest. Personio generiert sie nicht. Wenn Sie eine individuelle Integration erstellen, empfiehlt Personio dringend, die X-Personio-App-ID einzubeziehen, da diese bei der Fehlersuche und beim Support hilft. Erfahren Sie mehr über Werte und Formatierung im Developer Hub.

Recruiting-API

Wie behebe ich einen 404-Fehler beim Einreichen einer Bewerbung über die Recruiting-API?

Eine 404-Antwort bei POST /v1/recruiting/applications bedeutet in der Regel, dass die Stelle nicht den Status Veröffentlicht hat. Die API akzeptiert nur Bewerbungen für veröffentlichte Stellen. Für Stellen mit dem Status Entwurf oder einem anderen Status wird eine 404-Antwort zurückgegeben, auch wenn die Stelle in Personio vorhanden ist.

Um das zu beheben, gehen Sie zu Recruiting > Stellen, suchen Sie die entsprechende Position und prüfen Sie ihren Status. Wenn der Status Entwurf ist, ändern Sie ihn in Veröffentlicht und versuchen Sie die API-Anfrage erneut.

Kann ich Dokumente über die API an eine bestehende Recruiting-Bewerbung hochladen?

Nein. Die API unterstützt das Anhängen von Dokumenten nur beim Erstellen einer neuen Bewerbung, nicht bei einer bereits vorhandenen. Wenn Sie Dokumente an eine bestehende Bewerbung anhängen müssen, tun Sie dies manuell im Bewerbendenprofil.

Dokumente, die über den Upload-Endpunkt hochgeladen werden, ohne dass in einem Aufruf zum Erstellen einer Bewerbung direkt auf sie verwiesen wird, sind in Personio nirgends sichtbar. Führen Sie beide Schritte immer im selben Ablauf aus.

Kann ich Bewerbungsunterlagen wie Lebensläufe über die Personio API herunterladen?

Sie können Bewerbungsunterlagen über die Dokumentenmanagement-API herunterladen. Die Recruiting-API selbst bietet keinen Endpunkt zum Herunterladen von Dokumenten. Die Dokumentenmanagement-API unterstützt dies jedoch, wenn Sie die application_id als owner_id verwenden.

Befolgen Sie diese Schritte:

1. Generieren Sie über den Auth-Endpunkt mithilfe Ihrer API-Zugangsdaten ein Bearer-Token.
2. Verwenden Sie den Endpunkt List Applications, um Ihre application_id-Werte abzurufen. Sie können nach created_at filtern, um die Ergebnisse einzugrenzen.
3. Rufen Sie für jede application_id den Endpunkt List Document Metadata auf und verwenden Sie die application_id als owner_id.
4. Dadurch erhalten Sie die document_id-Werte der Dokumente, die mit dieser Bewerbung verknüpft sind.
5. Verwenden Sie jede document_id mit dem Endpunkt Download Document File, um die Datei herunterzuladen.
6. Sie benötigen für Dokumente und Recruiting Leserechte in Ihren API-Zugangsdaten.

Können benutzerdefinierte Attribute und Tags, die über die Recruiting-API geschrieben wurden, anschließend über die API abgerufen werden?

Nein. Die v2-Endpunkte für Bewerbende und Bewerbungen geben benutzerdefinierte Attribute oder Tags nicht in ihren Antworten zurück. Wenn Sie über POST einen Wert für ein benutzerdefiniertes Attribut oder Tag schreiben, geben die v2-GET-Endpunkte diesen Wert nicht zurück. Wenn Sie diesen Wert später abrufen oder überprüfen müssen, speichern Sie eine Kopie zum Zeitpunkt des Schreibens in Ihrem eigenen System.

Kann ich den Status einer Bewerbung oder den Status eines Bewerbenden über die Recruiting-API aktualisieren?

Nein. Die v2-Endpunkte der Recruiting-API für /applications, /candidates, /jobs und /applications/{id}/stage-transitions sind schreibgeschützt und unterstützen nur GET-Anfragen. Der einzige Schreib-Endpunkt in der Recruiting-API ist POST /v1/recruiting/applications. Damit können Sie eine neue Bewerbung erstellen, aber keine bestehende aktualisieren.

Um Statusänderungen in einem externen System nachzuverfolgen, rufen Sie die schreibgeschützten Endpunkte regelmäßig ab, um Änderungen im Zeitverlauf zu erkennen. Prüfen Sie im Personio Developer Hub, ob Webhooks für Recruiting-Ereignisse verfügbar sind.