Überblick
All-in-One-HR-Software für die Verwaltung von Mitarbeitern, Anwesenheit, Zeitkonten und Performance. Über die Langdock-Integration kannst du direkt aus deinen Chats auf Personio zugreifen und es verwalten.Authentifizierung: API Key
Kategorie: CRM & Kundensupport
Verfügbarkeit: Alle Workspace-Tarife
Kategorie: CRM & Kundensupport
Verfügbarkeit: Alle Workspace-Tarife
Verfügbare Aktionen
Personen auflisten
personio.listpersons
Ruft eine Liste von Personen mit optionalen Filtern ab
Bestätigung erforderlich: Nein
Parameter:
limit
(NUMBER, Optional): Anzahl der Personen pro Seite (1-50, Standard: 10)cursor
(TEXT, Optional): Cursor für die nächste Seite der Ergebnisseid
(TEXT, Optional): Nach spezifischer Personen-ID filternemail
(TEXT, Optional): Nach E-Mail-Adresse filternfirst_name
(TEXT, Optional): Nach Vorname filternlast_name
(TEXT, Optional): Nach Nachname filternpreferred_name
(TEXT, Optional): Nach bevorzugtem Namen filterncreated_at
(TEXT, Optional): Nach Erstellungsdatum filtern (YYYY-MM-DD)created_at_gt
(TEXT, Optional): Personen nach diesem Datum erstellt filtern (YYYY-MM-DD)created_at_lt
(TEXT, Optional): Personen vor diesem Datum erstellt filtern (YYYY-MM-DD)updated_at
(TEXT, Optional): Nach Aktualisierungsdatum filtern (YYYY-MM-DD)updated_at_gt
(TEXT, Optional): Personen nach diesem Datum aktualisiert filtern (YYYY-MM-DD)updated_at_lt
(TEXT, Optional): Personen vor diesem Datum aktualisiert filtern (YYYY-MM-DD)
Person abrufen
personio.getperson
Ruft eine einzelne Person nach ID ab
Bestätigung erforderlich: Nein
Parameter:
id
(TEXT, Required): Eindeutige Kennung des Mitarbeiters (z.B. “12345678”)
Person erstellen
personio.createperson
Erstellt eine neue Person und Anstellung
Bestätigung erforderlich: Ja
Parameter:
first_name
(TEXT, Required): Vorname des Mitarbeiterslast_name
(TEXT, Required): Nachname des Mitarbeitersemail
(TEXT, Optional): E-Mail-Adresse des Mitarbeiters. Muss unter allen Mitarbeitern einzigartig seinpreferred_name
(TEXT, Optional): Bevorzugter Name des Mitarbeiters, falls relevantgender
(TEXT, Optional): Geschlecht des Mitarbeiters (z.B. MALE, FEMALE, DIVERSE)language_code
(TEXT, Optional): Hauptsprache des Mitarbeiters (z.B. ‘de’ für Deutsch, ‘en’ für Englisch)custom_attributes
(MULTI_LINE_TEXT, Optional): Benutzerdefinierte Attribute als JSON-Array oder -Objektemployments
(MULTI_LINE_TEXT, Optional): Anstellungsdetails als JSON-Array
Person löschen
personio.deleteperson
Löscht eine Person
Bestätigung erforderlich: Ja
Parameter:
id
(TEXT, Required): Eindeutige Kennung des zu löschenden Mitarbeiters (z.B. “12345678”)
Anstellungen auflisten
personio.listemployments
Listet Anstellungen einer gegebenen Person auf
Bestätigung erforderlich: Nein
Parameter:
person_id
(TEXT, Required): Eindeutige Kennung der Person (z.B. “12345678”)limit
(NUMBER, Optional): Anzahl der Anstellungen pro Seite (1-50, Standard: 10)cursor
(TEXT, Optional): Cursor für die nächste Seite der Ergebnisseid
(TEXT, Optional): Nach spezifischer Anstellungs-ID filternupdated_at
(TEXT, Optional): Nach Aktualisierungsdatum filtern (YYYY-MM-DD)updated_at_gt
(TEXT, Optional): Anstellungen nach diesem Datum aktualisiert filtern (YYYY-MM-DD)updated_at_lt
(TEXT, Optional): Anstellungen vor diesem Datum aktualisiert filtern (YYYY-MM-DD)
Anstellung abrufen
personio.getemployment
Ruft eine einzelne Anstellung nach ID ab
Bestätigung erforderlich: Nein
Parameter:
person_id
(TEXT, Required): Eindeutige Kennung der Person (z.B. “12345678”)id
(TEXT, Required): Eindeutige Kennung der Anstellung (z.B. “98765432”)
Anstellung aktualisieren
personio.updateemployment
Aktualisiert einen Anstellungsdatensatz
Bestätigung erforderlich: Ja
Parameter:
person_id
(TEXT, Required): Eindeutige Kennung der Person (z.B. “12345678”)employment_id
(TEXT, Required): Eindeutige Kennung der zu aktualisierenden Anstellungsupervisor
(MULTI_LINE_TEXT, Optional): Vorgesetzter-Objekt als JSONoffice
(MULTI_LINE_TEXT, Optional): Büro-Objekt als JSONorg_units
(MULTI_LINE_TEXT, Optional): Organisationseinheiten (Abteilung/Team) als JSON-Arraylegal_entity
(MULTI_LINE_TEXT, Optional): Juristische Person als JSON-Objektposition
(MULTI_LINE_TEXT, Optional): Position als JSON-Objektstatus
(TEXT, Optional): Anstellungsstatus (z.B. ACTIVE, INACTIVE)employment_start_date
(TEXT, Optional): Wann der Arbeitsvertrag beginnt (YYYY-MM-DD)type
(TEXT, Optional): Art der Anstellung (z.B. INTERNAL, EXTERNAL)contract_end_date
(TEXT, Optional): Wann der Arbeitsvertrag endet, falls befristet (YYYY-MM-DD)probation_end_date
(TEXT, Optional): Wann die Probezeit endet (YYYY-MM-DD)probation_period_length
(NUMBER, Optional): Länge der Probezeit in Monatenweekly_working_hours
(NUMBER, Optional): Anzahl der wöchentlich gearbeiteten Stundenfull_time_weekly_working_hours
(NUMBER, Optional): Stunden pro Woche, die für diese Anstellung als Vollzeit geltencost_centers
(MULTI_LINE_TEXT, Optional): Gewichtungsverteilung zwischen Kostenstellen als JSON-Array mit Prozentsätzen
Person aktualisieren
personio.updateperson
Aktualisiert Informationen einer Person
Bestätigung erforderlich: Ja
Parameter:
id
(TEXT, Required): Eindeutige Kennung des zu aktualisierenden Mitarbeiters (z.B. “12345678”)email
(TEXT, Optional): E-Mail-Adresse des Mitarbeiters. Muss unter allen Mitarbeitern einzigartig seinfirst_name
(TEXT, Optional): Vorname des Mitarbeiterslast_name
(TEXT, Optional): Nachname des Mitarbeiterspreferred_name
(TEXT, Optional): Bevorzugter Name des Mitarbeiters, falls relevantgender
(TEXT, Optional): Geschlecht des Mitarbeiters (z.B. MALE, FEMALE, DIVERSE)language_code
(TEXT, Optional): Hauptsprache des Mitarbeiters (z.B. ‘de’ für Deutsch, ‘en’ für Englisch)custom_attributes
(MULTI_LINE_TEXT, Optional): Benutzerdefinierte Attribute als JSON-Array oder -Objekt
Anwesenheit abrufen
personio.getattendance
Ruft Anwesenheitsdatensätze mit Datumsbereich und Mitarbeiterfilterung ab
Bestätigung erforderlich: Nein
Parameter:
limit
(NUMBER, Optional): Maximale Anzahl der zurückzugebenden Anwesenheitsperioden (1-100, Standard: 100)cursor
(TEXT, Optional): Cursor für die nächste Seite der Ergebnisseid
(TEXT, Optional): Nach Anwesenheitsperioden-IDs filtern (kommagetrennt für mehrere)person_id
(TEXT, Optional): Nach Personen-IDs filtern (kommagetrennt für mehrere)start_gte
(TEXT, Optional): Perioden ab diesem Zeitpunkt filtern (ISO-8601)start_lte
(TEXT, Optional): Perioden bis zu diesem Zeitpunkt filtern (ISO-8601)end_lte
(TEXT, Optional): Perioden, die vor oder zu diesem Zeitpunkt enden, filtern (ISO-8601)end_gte
(TEXT, Optional): Perioden, die nach oder zu diesem Zeitpunkt enden, filtern (ISO-8601)updated_at_gte
(TEXT, Optional): Perioden nach oder zu diesem Zeitpunkt aktualisiert filtern (ISO-8601)updated_at_lte
(TEXT, Optional): Perioden vor oder zu diesem Zeitpunkt aktualisiert filtern (ISO-8601)status
(TEXT, Optional): Nach Status der Anwesenheitsperiode filtern
Anwesenheitsperiode abrufen
personio.getattendanceperiod
Ruft eine einzelne Anwesenheitsperiode nach ID ab
Bestätigung erforderlich: Nein
Parameter:
id
(TEXT, Required): ID der abzurufenden Anwesenheitsperiode
Anwesenheit erstellen
personio.createattendance
Erstellt einen neuen Anwesenheitseintrag für einen Mitarbeiter
Bestätigung erforderlich: Ja
Parameter:
person_id
(TEXT, Required): Eindeutige Kennung der Persontype
(TEXT, Required): Anwesenheitsperiodentyp: WORK oder BREAKstart
(MULTI_LINE_TEXT, Required): Startdatum/zeit als JSON:{"date_time": "2024-01-01T09:00:00"}
end
(MULTI_LINE_TEXT, Optional): Enddatum/zeit als JSON:{"date_time": "2024-01-01T17:00:00"}
comment
(TEXT, Optional): Optionaler Kommentar für die Anwesenheitsperiodeproject_id
(TEXT, Optional): Projekt-ID (nur für WORK-Perioden, muss ACTIVE sein)skip_approval
(BOOLEAN, Optional): Alle Genehmigungen überspringen, die diese Anfrage sonst erfordern würde (Standard: false)
Anwesenheitsperiode aktualisieren
personio.updateattendanceperiod
Aktualisiert eine Anwesenheitsperiode nach ID
Bestätigung erforderlich: Ja
Parameter:
id
(TEXT, Required): ID der zu aktualisierenden Anwesenheitsperiodetype
(TEXT, Optional): Anwesenheitsperiodentyp: WORK oder BREAKstart
(MULTI_LINE_TEXT, Optional): Startdatum/zeit als JSON:{"date_time": "2024-01-01T09:00:00"}
end
(MULTI_LINE_TEXT, Optional): Enddatum/zeit als JSON:{"date_time": "2024-01-01T17:00:00"}
comment
(TEXT, Optional): Optionaler Kommentar für die Anwesenheitsperiodeproject_id
(TEXT, Optional): Projekt-ID (nur für WORK-Perioden, muss ACTIVE sein, oder null zum Entfernen)skip_approval
(BOOLEAN, Optional): Alle Genehmigungen überspringen, die diese Aktualisierung sonst erfordern würde (Standard: false)
Anwesenheitsperiode löschen
personio.deleteattendanceperiod
Löscht eine Anwesenheitsperiode nach ID
Bestätigung erforderlich: Ja
Parameter:
id
(TEXT, Required): ID der zu löschenden Anwesenheitsperiode
Abwesenheitsperiode erstellen
personio.createabsenceperiod
Erstellt eine neue Abwesenheitsperiode
Bestätigung erforderlich: Ja
Parameter:
person_id
(TEXT, Required): Eindeutige Kennung der Personabsence_type_id
(TEXT, Required): ID des Abwesenheitstyps (UUID-Format)starts_from
(MULTI_LINE_TEXT, Required): Beginn der Abwesenheit als JSON:{"date_time": "2025-12-29T00:00:00", "type": "FIRST_HALF"}
ends_at
(MULTI_LINE_TEXT, Optional): Ende der Abwesenheit als JSON:{"date_time": "2026-01-01T00:00:00", "type": "SECOND_HALF"}
comment
(TEXT, Optional): Optionaler Kommentar für die Abwesenheitsperiodeskip_approval
(BOOLEAN, Optional): Alle Genehmigungen überspringen, die diese Anfrage sonst erfordern würde (Standard: false)
Vergütungstypen auflisten
personio.listcompensationtypes
Gibt eine Liste von Vergütungstypen einschließlich einmaliger und wiederkehrender Typen zurück
Bestätigung erforderlich: Nein
Parameter:
limit
(NUMBER, Optional): Anzahl der Vergütungstypen pro Seite (1-100, Standard: 100)cursor
(TEXT, Optional): Cursor für die nächste Seite der Ergebnisse
Vergütungstyp erstellen
personio.createcompensationtype
Erstellt einen neuen Vergütungstyp, der beim Erstellen von Vergütungen verwendet werden kann
Bestätigung erforderlich: Ja
Parameter:
name
(TEXT, Required): Name des Vergütungstypscategory
(TEXT, Required): Auszahlungshäufigkeit: ONE_TIME oder RECURRING
Vergütung erstellen
personio.createcompensation
Erstellt eine Vergütung für einen Mitarbeiter (einmalig, wiederkehrend, fest oder stündlich). Boni werden nicht unterstützt
Bestätigung erforderlich: Ja
Parameter:
person_id
(TEXT, Required): Personen-ID oder Personen-Objekt als JSON{"id": "12345678"}
type_id
(TEXT, Required): Vergütungstyp-ID oder Typ-Objekt als JSON{"id": "uuid"}
value
(NUMBER, Required): Betrag in numerischer Einheit der Währung mit bis zu 2 Dezimalstelleneffective_from
(TEXT, Required): Gültigkeitsbeginn der Vergütung (YYYY-MM-DD)interval
(TEXT, Optional): Auszahlungsintervall: MONTHLY, YEARLY (obligatorisch für RECURRING, ignoriert für ONE_TIME)comment
(TEXT, Optional): Optionaler Kommentar zu dieser Vergütung
Juristische Personen auflisten
personio.listlegalentities
Gibt eine Liste juristischer Personen des Unternehmens zurück, sortiert nach Erstellungsdatum
Bestätigung erforderlich: Nein
Parameter:
id
(TEXT, Optional): Nach einer oder mehreren IDs juristischer Personen filtern (kommagetrennt für mehrere)country
(TEXT, Optional): Nach Ländercodes filtern (kommagetrennt für mehrere, z.B. DE,US)limit
(NUMBER, Optional): Anzahl juristischer Personen pro Seite (1-100, Standard: 20)cursor
(TEXT, Optional): Cursor für die nächste Seite der Ergebnisse
Juristische Person abrufen
personio.getlegalentity
Ruft eine einzelne juristische Person nach ID ab
Bestätigung erforderlich: Nein
Parameter:
id
(TEXT, Required): ID der abzurufenden juristischen Person
Organisationseinheit abrufen
personio.getorgunit
Ruft eine Organisationseinheit (Team oder Abteilung) nach ID ab. Erhalte Org-Unit-IDs aus list_employments- oder get_employment-Antworten
Bestätigung erforderlich: Nein
Parameter:
id
(TEXT, Required): ID der abzurufenden Org Unit. Erhalte diese aus list_employments- oder employment-Datensätzentype
(TEXT, Required): Typ der Org Unit (z.B. team oder department)include_parent_chain
(BOOLEAN, Optional): Übergeordnete Org-Unit-Kette in der Antwort einschließen (Standard: false)
Abwesenheitsperioden auflisten
personio.listabsenceperiods
Gibt eine Liste von Abwesenheitsperioden mit Paginierung und Filterung zurück
Bestätigung erforderlich: Nein
Parameter:
limit
(NUMBER, Optional): Maximale Anzahl der zurückzugebenden Abwesenheitsperioden (1-100, Standard: 100)cursor
(TEXT, Optional): Cursor für die nächste Seite der Ergebnisseid
(TEXT, Optional): Nach einer oder mehreren Abwesenheitsperioden-IDs filternabsence_type_id
(TEXT, Optional): Nach einer oder mehreren Abwesenheitstyp-IDs filternperson_id
(TEXT, Optional): Nach einer oder mehreren Personen-IDs filternstarts_from_gte
(TEXT, Optional): Perioden ab diesem Zeitpunkt filtern (inklusiv, ISO-8601)starts_from_lte
(TEXT, Optional): Perioden bis zu diesem Zeitpunkt filtern (ISO-8601)ends_at_lte
(TEXT, Optional): Perioden, die vor oder zu diesem Zeitpunkt enden, filtern (ISO-8601)ends_at_gte
(TEXT, Optional): Perioden, die nach oder zu diesem Zeitpunkt enden, filtern (ISO-8601)updated_at_gte
(TEXT, Optional): Perioden nach oder zu diesem Zeitpunkt aktualisiert filtern (ISO-8601)updated_at_lte
(TEXT, Optional): Perioden vor oder zu diesem Zeitpunkt aktualisiert filtern (ISO-8601)
Abwesenheitsperiode abrufen
personio.getabsenceperiod
Ruft eine Abwesenheitsperiode nach ID ab. Erhalte Abwesenheitsperioden-IDs aus list_absence_periods- oder create_absence-Antworten
Bestätigung erforderlich: Nein
Parameter:
id
(TEXT, Required): ID der abzurufenden Abwesenheitsperiode. Erhalte diese aus list_absence_periods- oder create_absence-Antworten
Abwesenheitsperiode aktualisieren
personio.updateabsenceperiod
Aktualisiert eine Abwesenheitsperiode nach ID
Bestätigung erforderlich: Ja
Parameter:
id
(TEXT, Required): ID der zu aktualisierenden Abwesenheitsperiodestarts_from
(MULTI_LINE_TEXT, Optional): Beginn der Abwesenheitsperiode als JSON-Objekt:{"date_time": "2025-12-29T00:00:00", "type": "FIRST_HALF"}
ends_at
(MULTI_LINE_TEXT, Optional): Ende der Abwesenheitsperiode als JSON-Objekt:{"date_time": "2026-01-01T00:00:00", "type": "SECOND_HALF"}
comment
(TEXT, Optional): Optionaler Kommentar für die Abwesenheitsperiodeskip_approval
(BOOLEAN, Optional): Alle Genehmigungen überspringen, die diese Aktualisierung sonst erfordern würde (Standard: false)
Abwesenheitsperiode löschen
personio.deleteabsenceperiod
Löscht eine Abwesenheitsperiode nach ID
Bestätigung erforderlich: Ja
Parameter:
id
(TEXT, Required): ID der zu löschenden Abwesenheitsperiode
Abwesenheitsperioden-Aufschlüsselungen abrufen
personio.getabsenceperiodbreakdowns
Ruft tägliche Aufschlüsselungen für eine Abwesenheitsperiode ab
Bestätigung erforderlich: Nein
Parameter:
id
(TEXT, Required): ID der Abwesenheitsperiodelimit
(NUMBER, Optional): Anzahl der Aufschlüsselungstage (1-28, Standard: 28)cursor
(TEXT, Optional): Cursor für die nächste Seite der Ergebnisse
Freistellungstypen abrufen
personio.gettimeofftypes
Ruft alle verfügbaren Freistellungstypen ab
Bestätigung erforderlich: Nein
Parameter:
limit
(NUMBER, Optional): Maximale Anzahl der zurückzugebenden Abwesenheitstypen (1-100, Standard: 100)cursor
(TEXT, Optional): Cursor für die nächste Seite der Ergebnisse
Abwesenheitstyp abrufen
personio.getabsencetype
Ruft einen Abwesenheitstyp nach ID ab
Bestätigung erforderlich: Nein
Parameter:
id
(TEXT, Required): ID des Abwesenheitstyps (UUID-Format)
Dokumente auflisten
personio.listdocuments
Listet die Metadaten von Dokumenten auf, die zur angegebenen Besitzer-ID gehören
Bestätigung erforderlich: Nein
Parameter:
owner_id
(TEXT, Required): ID des Besitzers der Dokumentecategory_id
(TEXT, Optional): ID der Kategorie, zu der die Dokumente gehörencreated_at_gte
(TEXT, Optional): Dokumente filtern, die an oder nach diesem Datum erstellt wurden (YYYY-MM-DD)created_at_lt
(TEXT, Optional): Dokumente filtern, die vor diesem Datum erstellt wurden (YYYY-MM-DD)limit
(NUMBER, Optional): Anzahl der zurückzugebenden Dokumente (1-200, Standard: 100)cursor
(TEXT, Optional): Cursor für die nächste Seite der Ergebnisse
Dokument löschen
personio.deletedocument
Löscht ein Dokument mit der angegebenen Dokument-ID
Bestätigung erforderlich: Ja
Parameter:
document_id
(TEXT, Required): ID des zu löschenden Dokuments
Vergütungen auflisten
personio.listcompensations
Gibt Lohnvergütungen einschließlich Gehalt, stündlich, einmalig, wiederkehrend und Boni zurück
Bestätigung erforderlich: Nein
Parameter:
start_date
(TEXT, Optional): Startdatum für Vergütungen (YYYY-MM-DD). Dauer mit end_date muss ≤ 1 Monat seinend_date
(TEXT, Optional): Enddatum für Vergütungen (YYYY-MM-DD). Dauer mit start_date muss ≤ 1 Monat seinperson_id
(TEXT, Optional): Nach einer oder mehreren Personen-IDs filtern (kommagetrennt für mehrere)legal_entity_id
(TEXT, Optional): Nach einer oder mehreren IDs juristischer Personen filtern (kommagetrennt für mehrere)limit
(NUMBER, Optional): Anzahl der Vergütungen pro Seite (1-100, Standard: 100)cursor
(TEXT, Optional): Cursor für die nächste Seite der Ergebnisse
Person nach E-Mail suchen
personio.searchpersonbyemail
Findet eine Person über ihre E-Mail-Adresse
Bestätigung erforderlich: Nein
Parameter:
email
(TEXT, Required): E-Mail-Adresse des zu suchenden Mitarbeiters
Freistellungsguthaben abrufen
personio.gettimeoffbalance
Ruft das Freistellungsguthaben für eine Person ab
Bestätigung erforderlich: Nein
Parameter:
employeeId
(TEXT, Required): Eindeutige Kennung des Mitarbeiters
Benutzerdefinierte Attribute abrufen
personio.getcustomattributes
Ruft die Liste der in Personio definierten benutzerdefinierten Attribute ab
Bestätigung erforderlich: Nein
Parameter: Keine
Output: Gibt eine Liste benutzerdefinierter Attribute zurück
Bewerbungen auflisten
personio.listapplications
Ruft eine Liste von Recruiting-Bewerbungen mit optionalen Filtern ab
Bestätigung erforderlich: Nein
Parameter:
limit
(NUMBER, Optional): Anzahl der zurückzugebenden Bewerbungen (1-200, Standard: 100)cursor
(TEXT, Optional): Cursor für die nächste Seite der Ergebnisseupdated_at_lt
(TEXT, Optional): Bewerbungen vor diesem Datum/Zeit zurückgeben (ISO 8601-Format). Kann nicht mit ‘Updated after’ verwendet werdenupdated_at_gt
(TEXT, Optional): Bewerbungen nach diesem Datum/Zeit zurückgeben (ISO 8601-Format). Kann nicht mit ‘Updated before’ verwendet werdencandidate_email
(TEXT, Optional): Bewerbungen nach Kandidaten-E-Mail-Adresse filtern
Bewerbung abrufen
personio.getapplication
Ruft eine Recruiting-Bewerbung nach ID ab
Bestätigung erforderlich: Nein
Parameter:
id
(TEXT, Required): Eindeutige Kennung der Bewerbung
Bewerbungs-Stadium-Übergänge abrufen
personio.getapplicationstagetransitions
Ruft die Historie der Stadium-Übergänge für eine Recruiting-Bewerbung ab
Bestätigung erforderlich: Nein
Parameter:
id
(TEXT, Required): Eindeutige Kennung der Bewerbung
Kandidaten auflisten
personio.listcandidates
Ruft eine Liste von Recruiting-Kandidaten mit optionalen Filtern ab
Bestätigung erforderlich: Ja
Parameter:
limit
(NUMBER, Optional): Anzahl der zurückzugebenden Kandidaten (1-200, Standard: 100)cursor
(TEXT, Optional): Cursor für die nächste Seite der Ergebnisseupdated_at_lt
(TEXT, Optional): Kandidaten vor diesem Datum/Zeit zurückgeben (ISO 8601-Format). Kann nicht mit ‘Updated after’ verwendet werdenupdated_at_gt
(TEXT, Optional): Kandidaten nach diesem Datum/Zeit zurückgeben (ISO 8601-Format). Kann nicht mit ‘Updated before’ verwendet werdenemail
(TEXT, Optional): Kandidaten nach E-Mail-Adresse filtern
Kandidat abrufen
personio.getcandidate
Ruft einen Recruiting-Kandidaten nach ID ab
Bestätigung erforderlich: Ja
Parameter:
id
(TEXT, Required): Eindeutige Kennung des Kandidaten
Jobs auflisten
personio.listjobs
Ruft eine Liste von Recruiting-Jobs mit optionalen Filtern ab
Bestätigung erforderlich: Nein
Parameter:
limit
(NUMBER, Optional): Anzahl der zurückzugebenden Jobs (1-200, Standard: 100)cursor
(TEXT, Optional): Cursor für die nächste Seite der Ergebnisseupdated_at_lt
(TEXT, Optional): Jobs vor diesem Datum/Zeit zurückgeben (ISO 8601-Format). Kann nicht mit ‘Updated after’ verwendet werdenupdated_at_gt
(TEXT, Optional): Jobs nach diesem Datum/Zeit zurückgeben (ISO 8601-Format). Kann nicht mit ‘Updated before’ verwendet werden
Job abrufen
personio.getjob
Ruft einen Recruiting-Job nach ID ab
Bestätigung erforderlich: Nein
Parameter:
id
(TEXT, Required): Eindeutige Kennung des Jobs
Job-Kategorien auflisten
personio.listjobcategories
Ruft alle Recruiting-Job-Kategorien ab
Bestätigung erforderlich: Nein
Parameter: Keine
Output: Gibt eine Liste von Job-Kategorien zurück
Job-Kategorie abrufen
personio.getjobcategory
Ruft eine Recruiting-Job-Kategorie nach ID ab
Bestätigung erforderlich: Nein
Parameter:
id
(TEXT, Required): Eindeutige Kennung der Job-Kategorie
Kostenstellen auflisten
personio.listcostcenters
Ruft eine Liste von Kostenstellen mit Filterung, Sortierung und Paginierung ab
Bestätigung erforderlich: Ja
Parameter:
id
(TEXT, Optional): Nach einer oder mehreren Kostenstellen-IDs filtern (kommagetrennt)name
(TEXT, Optional): Nach einem oder mehreren Kostenstellennamen filtern (kommagetrennt)sort
(TEXT, Optional): Ergebnisse nach Feld sortieren. Verwende Feldname für aufsteigend (z.B. ‘name’) oder Minuszeichen für absteigend (z.B. ‘-name’). Optionen: id, -id, name, -namelimit
(NUMBER, Optional): Anzahl der zurückzugebenden Kostenstellen (1-100, Standard: 50)cursor
(TEXT, Optional): Cursor für die nächste Seite der Ergebnisse
Arbeitsplätze auflisten
personio.listworkplaces
Ruft eine Liste von Arbeitsplätzen mit Filterung, Sortierung und Paginierung ab
Bestätigung erforderlich: Nein
Parameter:
id
(TEXT, Optional): Nach einer oder mehreren Arbeitsplatz-IDs filtern (kommagetrennt)name
(TEXT, Optional): Nach einem oder mehreren Arbeitsplatznamen filtern (kommagetrennt)sort
(TEXT, Optional): Ergebnisse nach Feld sortieren. Verwende Feldname für aufsteigend (z.B. ‘name’) oder Minuszeichen für absteigend (z.B. ‘-name’). Optionen: id, -id, name, -namelimit
(NUMBER, Optional): Anzahl der zurückzugebenden Arbeitsplätze (1-100, Standard: 50)cursor
(TEXT, Optional): Cursor für die nächste Seite der Ergebnisse
Häufige Anwendungsfälle
Datenverwaltung
Verwalte und organisiere deine Personio-Daten
Automatisierung
Automatisiere Workflows mit Personio
Reporting
Erstelle Einblicke und Berichte
Integration
Verbinde Personio mit anderen Tools
Best Practices
Erste Schritte:
- Aktiviere die Personio-Integration in deinen Workspace-Einstellungen
- Authentifiziere dich über API Key
- Teste die Verbindung mit einer einfachen Leseabfrage
- Erkunde verfügbare Aktionen für deinen Anwendungsfall
Wichtige Überlegungen:
- Stelle sicher, dass du die richtigen Authentifizierungsdaten hast
- Respektiere Rate Limits und API-Kontingente
- Prüfe Datenschutzeinstellungen
- Teste Aktionen zuerst in einer sicheren Umgebung
Fehlerbehebung
Problem | Lösung |
---|---|
Authentifizierung fehlgeschlagen | Überprüfe deine API Key-Anmeldedaten |
Rate Limit überschritten | Reduziere die Anfragehäufigkeit |
Daten nicht gefunden | Prüfe Berechtigungen und Datenverfügbarkeit |
Verbindungstimeout | Überprüfe die Netzwerkverbindung |