Personio

Overzicht

All-in-one HR-software voor het beheren van medewerkers, aanwezigheid, tijdsrekeningen en prestaties. Via Langdock’s integratie kunt u Personio rechtstreeks vanuit uw gesprekken openen en beheren.

Authenticatie: API-sleutel Categorie: CRM & Klantenservice Beschikbaarheid: Alle workspace-abonnementen

Beschikbare acties

Personen weergeven

personio.listpersons

Krijg een lijst met personen met optionele filters Vereist bevestiging: Nee Parameters:

  • limit (NUMMER, Optioneel): Aantal personen dat per pagina wordt geretourneerd (1-50, standaard: 10)

  • cursor (TEKST, Optioneel): Paginatie-cursor voor de volgende pagina met resultaten

  • id (TEKST, Optioneel): Filter op specifieke persoon-ID

  • email (TEKST, Optioneel): Filter op e-mailadres

  • first_name (TEKST, Optioneel): Filter op voornaam

  • last_name (TEKST, Optioneel): Filter op achternaam

  • preferred_name (TEKST, Optioneel): Filter op voorkeursnaam

  • created_at (TEKST, Optioneel): Filter op creatiedatum (JJJJ-MM-DD)

  • created_at_gt (TEKST, Optioneel): Filter personen gemaakt na deze datum (JJJJ-MM-DD)

  • created_at_lt (TEKST, Optioneel): Filter personen gemaakt vóór deze datum (JJJJ-MM-DD)

  • updated_at (TEKST, Optioneel): Filter op bijgewerkte datum (JJJJ-MM-DD)

  • updated_at_gt (TEKST, Optioneel): Filter personen bijgewerkt na deze datum (JJJJ-MM-DD)

  • updated_at_lt (TEKST, Optioneel): Filter personen bijgewerkt vóór deze datum (JJJJ-MM-DD)

Uitvoer: Geeft een lijst terug van personen met hun details inclusief ID, naam, e-mail en dienstverbandinformatie


Get persoon

personio.getperson

Haal een enkele persoon op via ID Vereist bevestiging: Nee Parameters:

  • id (TEKST, Verplicht): De unieke identifier van de werknemer (bijv. “12345678”)

Uitvoer: Geeft de specifieke persoonsgegevens terug


Persoon aanmaken

personio.createperson

Maak een nieuwe persoon en dienstverband aan Vereist bevestiging: Ja Parameters:

  • first_name (TEKST, Verplicht): Voornaam van de werknemer

  • last_name (TEKST, Verplicht): Achternaam van de werknemer

  • email (TEKST, Optioneel): E-mailadres van de werknemer. Moet uniek zijn voor alle werknemers

  • preferred_name (TEKST, Optioneel): De voorkeursnaam van de werknemer, indien van toepassing

  • gender (TEKST, Optioneel): Geslacht van de werknemer (bijv. MALE, FEMALE, DIVERSE)

  • language_code (TEKST, Optioneel): Hoofdtaal van de werknemer (bijv. ‘de’ voor Duits, ‘en’ voor Engels)

  • custom_attributes (MEERREGELIGE_TEKST, Optioneel): Aangepaste attributen als JSON-array of object

  • employments (MEERREGELIGE_TEKST, Optioneel): Dienstverbandgegevens als JSON-array

Uitvoer: Geeft de aangemaakte persoon terug met hun ID en details


Persoon verwijderen

personio.deleteperson

Verwijder een persoon Vereist bevestiging: Ja Parameters:

  • id (TEKST, Verplicht): De unieke identifier van de werknemer die verwijderd moet worden (bijv. “12345678”)

Uitvoer: Bevestiging van verwijdering


Werkverbanden weergeven

personio.listemployments

Lijst met dienstverbanden van een opgegeven persoon Vereist bevestiging: Nee Parameters:

  • person_id (TEKST, Verplicht): De unieke identifier van de persoon (bijv. “12345678”)

  • limit (NUMMER, Optioneel): Aantal dienstverbanden dat per pagina wordt geretourneerd (1-50, standaard: 10)

  • cursor (TEKST, Optioneel): Paginatie-cursor voor de volgende pagina met resultaten

  • id (TEKST, Optioneel): Filter op specifieke dienstverband-ID

  • updated_at (TEKST, Optioneel): Filter op bijgewerkte datum (JJJJ-MM-DD)

  • updated_at_gt (TEKST, Optioneel): Filter dienstverbanden bijgewerkt na deze datum (JJJJ-MM-DD)

  • updated_at_lt (TEKST, Optioneel): Filter dienstverbanden bijgewerkt vóór deze datum (JJJJ-MM-DD)

Uitvoer: Geeft een lijst terug van dienstverbanden voor de opgegeven persoon


Get dienstverband

personio.getemployment

Haal een enkel dienstverband op via ID Vereist bevestiging: Nee Parameters:

  • person_id (TEKST, Verplicht): De unieke identifier van de persoon (bijv. “12345678”)

  • id (TEKST, Verplicht): De unieke identifier van het dienstverband (bijv. “98765432”)

Uitvoer: Geeft de specifieke dienstverbandgegevens terug


Dienstverband bijwerken

personio.updateemployment

Werk een dienstverbandrecord bij Vereist bevestiging: Ja Parameters:

  • person_id (TEKST, Verplicht): De unieke identifier van de persoon (bijv. “12345678”)

  • employment_id (TEKST, Verplicht): De unieke identifier van het dienstverband dat bijgewerkt moet worden

  • supervisor (MEERREGELIGE_TEKST, Optioneel): Supervisor-object als JSON

  • office (MEERREGELIGE_TEKST, Optioneel): Kantoorobject als JSON

  • org_units (MEERREGELIGE_TEKST, Optioneel): Organisatie-eenheden (afdeling/team) als JSON-array

  • legal_entity (MEERREGELIGE_TEKST, Optioneel): Rechtspersoon-object als JSON

  • position (MEERREGELIGE_TEKST, Optioneel): Functie-object als JSON

  • status (TEKST, Optioneel): Dienstverbandstatus (bijv. ACTIVE, INACTIVE)

  • employment_start_date (TEKST, Optioneel): Wanneer het dienstverband begint (JJJJ-MM-DD)

  • type (TEKST, Optioneel): Type dienstverband (bijv. INTERNAL, EXTERNAL)

  • contract_end_date (TEKST, Optioneel): Wanneer het dienstverband eindigt, indien tijdelijk (JJJJ-MM-DD)

  • probation_end_date (TEKST, Optioneel): Wanneer de proeftijd eindigt (JJJJ-MM-DD)

  • probation_period_length (NUMMER, Optioneel): Duur van de proeftijd in maanden

  • weekly_working_hours (NUMMER, Optioneel): Aantal uren dat per week wordt gewerkt

  • full_time_weekly_working_hours (NUMMER, Optioneel): Uren per week die als voltijds gelden voor dit dienstverband

  • cost_centers (MEERREGELIGE_TEKST, Optioneel): Weging tussen kostenplaatsen als JSON-array met percentages

Uitvoer: Geeft de bijgewerkte dienstverbandgegevens terug


Persoon bijwerken

personio.updateperson

Werk de informatie van een persoon bij Vereist bevestiging: Ja Parameters:

  • id (TEKST, Verplicht): De unieke identifier van de werknemer die bijgewerkt moet worden (bijv. “12345678”)

  • email (TEKST, Optioneel): E-mailadres van de werknemer. Moet uniek zijn voor alle werknemers

  • first_name (TEKST, Optioneel): Voornaam van de werknemer

  • last_name (TEKST, Optioneel): Achternaam van de werknemer

  • preferred_name (TEKST, Optioneel): De voorkeursnaam van de werknemer, indien van toepassing

  • gender (TEKST, Optioneel): Geslacht van de werknemer (bijv. MALE, FEMALE, DIVERSE)

  • language_code (TEKST, Optioneel): Hoofdtaal van de werknemer (bijv. ‘de’ voor Duits, ‘en’ voor Engels)

  • custom_attributes (MEERREGELIGE_TEKST, Optioneel): Aangepaste attributen als JSON-array of object

Uitvoer: Geeft de bijgewerkte persoonsgegevens terug


Get aanwezigheid

personio.getattendance

Krijg aanwezigheidsgegevens met datumbereik en werknemerfiltering Vereist bevestiging: Nee Parameters:

  • limit (NUMMER, Optioneel): Maximum aantal aanwezigheidsperioden dat geretourneerd wordt (1-100, standaard: 100)

  • cursor (TEKST, Optioneel): Paginatie-cursor voor de volgende pagina met resultaten

  • id (TEKST, Optioneel): Filter op aanwezigheidsperiode-IDs (komma-gescheiden voor meerdere)

  • person_id (TEKST, Optioneel): Filter op persoon-IDs (komma-gescheiden voor meerdere)

  • start_gte (TEKST, Optioneel): Filter periodes die starten vanaf deze datum-tijd (ISO-8601)

  • start_lte (TEKST, Optioneel): Filter periodes die starten vóór of op deze datum-tijd (ISO-8601)

  • end_lte (TEKST, Optioneel): Filter periodes die eindigen vóór of op deze datum-tijd (ISO-8601)

  • end_gte (TEKST, Optioneel): Filter periodes die eindigen na of op deze datum-tijd (ISO-8601)

  • updated_at_gte (TEKST, Optioneel): Filter periodes bijgewerkt na of op deze datum-tijd (ISO-8601)

  • updated_at_lte (TEKST, Optioneel): Filter periodes bijgewerkt vóór of op deze datum-tijd (ISO-8601)

  • status (TEKST, Optioneel): Filter op status van aanwezigheidsperiode

Uitvoer: Geeft een lijst terug van aanwezigheidsgegevens met details


Get aanwezigheidsperiode

personio.getattendanceperiod

Haal een enkele aanwezigheidsperiode op via ID Vereist bevestiging: Nee Parameters:

  • id (TEKST, Verplicht): De ID van de aanwezigheidsperiode om op te halen

Uitvoer: Geeft de specifieke aanwezigheidsperiodegegevens terug


Aanwezigheid aanmaken

personio.createattendance

Maak een nieuwe aanwezigheidsvermelding voor een werknemer Vereist bevestiging: Ja Parameters:

  • person_id (TEKST, Verplicht): De unieke identifier van de persoon

  • type (TEKST, Verplicht): Type aanwezigheidsperiode: WORK of BREAK

  • start (MEERREGELIGE_TEKST, Verplicht): Startdatum/-tijd als JSON: {"date_time": "2024-01-01T09:00:00"}

  • end (MEERREGELIGE_TEKST, Optioneel): Einddatum/-tijd als JSON: {"date_time": "2024-01-01T17:00:00"}

  • comment (TEKST, Optioneel): Optionele opmerking voor de aanwezigheidsperiode

  • project_id (TEKST, Optioneel): Project-ID (alleen voor WORK-periodes, moet ACTIVE zijn)

  • skip_approval (BOOLEAN, Optioneel): Sla eventuele goedkeuring over die anders vereist zou zijn (standaard: false)

Uitvoer: Geeft de aangemaakte aanwezigheidsvermelding terug


Aanwezigheidsperiode bijwerken

personio.updateattendanceperiod

Werk een aanwezigheidsperiode bij via ID Vereist bevestiging: Ja Parameters:

  • id (TEKST, Verplicht): De ID van de aanwezigheidsperiode die bijgewerkt moet worden

  • type (TEKST, Optioneel): Type aanwezigheidsperiode: WORK of BREAK

  • start (MEERREGELIGE_TEKST, Optioneel): Startdatum/-tijd als JSON: {"date_time": "2024-01-01T09:00:00"}

  • end (MEERREGELIGE_TEKST, Optioneel): Einddatum/-tijd als JSON: {"date_time": "2024-01-01T17:00:00"}

  • comment (TEKST, Optioneel): Optionele opmerking voor de aanwezigheidsperiode

  • project_id (TEKST, Optioneel): Project-ID (alleen voor WORK-periodes, moet ACTIVE zijn, of null om te verwijderen)

  • skip_approval (BOOLEAN, Optioneel): Sla eventuele goedkeuring over die anders vereist zou zijn (standaard: false)

Uitvoer: Geeft de bijgewerkte aanwezigheidsperiodegegevens terug


Aanwezigheidsperiode verwijderen

personio.deleteattendanceperiod

Verwijder een aanwezigheidsperiode via ID Vereist bevestiging: Ja Parameters:

  • id (TEKST, Verplicht): De ID van de aanwezigheidsperiode die verwijderd moet worden

Uitvoer: Bevestiging van verwijdering


Afwezigheidsperiode aanmaken

personio.createabsenceperiod

Maakt een nieuwe afwezigheidsperiode aan Vereist bevestiging: Ja Parameters:

  • person_id (TEKST, Verplicht): De unieke identifier van de persoon

  • absence_type_id (TEKST, Verplicht): De ID van het afwezigheidstype (UUID-formaat)

  • starts_from (MEERREGELIGE_TEKST, Verplicht): Begin van de afwezigheid als JSON: {"date_time": "2025-12-29T00:00:00", "type": "FIRST_HALF"}

  • ends_at (MEERREGELIGE_TEKST, Optioneel): Einde van de afwezigheid als JSON: {"date_time": "2026-01-01T00:00:00", "type": "SECOND_HALF"}

  • comment (TEKST, Optioneel): Optionele opmerking voor de afwezigheidsperiode

  • skip_approval (BOOLEAN, Optioneel): Sla eventuele goedkeuring over die anders vereist zou zijn (standaard: false)

Uitvoer: Geeft de aangemaakte afwezigheidsperiodegegevens terug


Lijst met vergoedingssoorten

personio.listcompensationtypes

Geeft een lijst terug van vergoedingssoorten inclusief eenmalige en terugkerende typen Vereist bevestiging: Nee Parameters:

  • limit (NUMMER, Optioneel): Aantal vergoedingssoorten dat per pagina wordt geretourneerd (1-100, standaard: 100)

  • cursor (TEKST, Optioneel): Paginatie-cursor voor de volgende pagina met resultaten

Uitvoer: Geeft een lijst terug van vergoedingssoorten


Vergoedingstype aanmaken

personio.createcompensationtype

Maakt een nieuw vergoedingstype aan dat gebruikt kan worden bij het aanmaken van vergoedingen Vereist bevestiging: Ja Parameters:

  • name (TEKST, Verplicht): Naam van het vergoedingstype

  • category (TEKST, Verplicht): Uitbetalingsfrequentie: ONE_TIME of RECURRING

Uitvoer: Geeft het aangemaakte vergoedingstype terug met details


Vergoeding aanmaken

personio.createcompensation

Maakt een vergoeding voor een werknemer aan (eenmalig, terugkerend, vast of per uur). Bonussen niet ondersteund Vereist bevestiging: Ja Parameters:

  • person_id (TEKST, Verplicht): De persoon-ID of persoonobject als JSON {"id": "12345678"}

  • type_id (TEKST, Verplicht): De vergoedingstype-ID of typeobject als JSON {"id": "uuid"}

  • waarde (NUMMER, Verplicht): Bedrag in de numerieke eenheid van de valuta met maximaal 2 decimalen

  • effective_from (TEKST, Verplicht): De ingangsdatum van de vergoeding (JJJJ-MM-DD)

  • interval (TEKST, Optioneel): Uitbetalingsinterval: MONTHLY, YEARLY (verplicht voor RECURRING, genegeerd voor ONE_TIME)

  • comment (TEKST, Optioneel): Optionele opmerking over deze vergoeding

Uitvoer: Geeft de aangemaakte vergoeding terug met details


Lijst met rechtspersonen

personio.listlegalentities

Geeft een lijst terug van rechtspersonen voor het bedrijf, gesorteerd op creatiedatum Vereist bevestiging: Nee Parameters:

  • id (TEKST, Optioneel): Filter op één of meer rechtspersoon-IDs (komma-gescheiden voor meerdere)

  • country (TEKST, Optioneel): Filter op landcodes (komma-gescheiden voor meerdere, bijv. DE,US)

  • limit (NUMMER, Optioneel): Aantal rechtspersonen dat per pagina wordt geretourneerd (1-100, standaard: 20)

  • cursor (TEKST, Optioneel): Paginatie-cursor voor de volgende pagina met resultaten

Uitvoer: Geeft een lijst terug van rechtspersonen


Get rechtspersoon

personio.getlegalentity

Haalt een enkele rechtspersoon op via ID Vereist bevestiging: Nee Parameters:

  • id (TEKST, Verplicht): De ID van de rechtspersoon om op te halen

Uitvoer: Geeft de specifieke rechtspersoongegevens terug


Get org unit

personio.getorgunit

Haalt een organisatie-eenheid (team of afdeling) op via ID. Verkrijg org-eenheid IDs uit list_employments of get_employment responses Vereist bevestiging: Nee Parameters:

  • id (TEKST, Verplicht): De ID van de Org Unit om op te halen. Verkrijg deze uit list_employments of dienstverbandrecords

  • type (TEKST, Verplicht): Het type van de Org Unit (bijv. team of afdeling)

  • include_parent_chain (BOOLEAN, Optioneel): Neem de bovenliggende org-eenhedenketen op in de respons (standaard: false)

Uitvoer: Geeft de organisatie-eenheidgegevens terug


Lijst met afwezigheidsperioden

personio.listabsenceperiods

Geeft een lijst terug van afwezigheidsperioden met paginatie en filtering Vereist bevestiging: Nee Parameters:

  • limit (NUMMER, Optioneel): Maximum aantal afwezigheidsperioden dat geretourneerd wordt (1-100, standaard: 100)

  • cursor (TEKST, Optioneel): Paginatie-cursor voor de volgende pagina met resultaten

  • id (TEKST, Optioneel): Filter op één of meer afwezigheidsperiode-IDs

  • absence_type_id (TEKST, Optioneel): Filter op één of meer afwezigheidstype-IDs

  • person_id (TEKST, Optioneel): Filter op één of meer persoon-IDs

  • starts_from_gte (TEKST, Optioneel): Filter periodes die starten vanaf deze datum-tijd (inclusief, ISO-8601)

  • starts_from_lte (TEKST, Optioneel): Filter periodes die starten vóór of op deze datum-tijd (ISO-8601)

  • ends_at_lte (TEKST, Optioneel): Filter periodes die eindigen vóór of op deze datum-tijd (ISO-8601)

  • ends_at_gte (TEKST, Optioneel): Filter periodes die eindigen na of op deze datum-tijd (ISO-8601)

  • updated_at_gte (TEKST, Optioneel): Filter periodes bijgewerkt na of op deze datum-tijd (ISO-8601)

  • updated_at_lte (TEKST, Optioneel): Filter periodes bijgewerkt vóór of op deze datum-tijd (ISO-8601)

Uitvoer: Geeft een lijst terug van afwezigheidsperioden


Get afwezigheidsperiode

personio.getabsenceperiod

Haalt een afwezigheidsperiode op via ID. Verkrijg afwezigheidsperiode-IDs uit list_absence_periods of create_absence responses Vereist bevestiging: Nee Parameters:

  • id (TEKST, Verplicht): De ID van de afwezigheidsperiode om op te halen. Verkrijg deze uit list_absence_periods of create_absence responses

Uitvoer: Geeft de specifieke afwezigheidsperiodegegevens terug


Afwezigheidsperiode bijwerken

personio.updateabsenceperiod

Werk een afwezigheidsperiode bij via ID Vereist bevestiging: Ja Parameters:

  • id (TEKST, Verplicht): De ID van de afwezigheidsperiode die bijgewerkt moet worden

  • starts_from (MEERREGELIGE_TEKST, Optioneel): Begin van afwezigheidsperiode als JSON-object: {"date_time": "2025-12-29T00:00:00", "type": "FIRST_HALF"}

  • ends_at (MEERREGELIGE_TEKST, Optioneel): Einde van afwezigheidsperiode als JSON-object: {"date_time": "2026-01-01T00:00:00", "type": "SECOND_HALF"}

  • comment (TEKST, Optioneel): Optionele opmerking voor de afwezigheidsperiode

  • skip_approval (BOOLEAN, Optioneel): Sla eventuele goedkeuring over die deze update anders zou vereisen (standaard: false)

Uitvoer: Geeft de bijgewerkte afwezigheidsperiodegegevens terug


Afwezigheidsperiode verwijderen

personio.deleteabsenceperiod

Verwijdert een afwezigheidsperiode via ID Vereist bevestiging: Ja Parameters:

  • id (TEKST, Verplicht): De ID van de afwezigheidsperiode die verwijderd moet worden

Uitvoer: Bevestiging van verwijdering


Get afwezigheidsperiode uitsplitsingen

personio.getabsenceperiodbreakdowns

Haalt dagelijkse uitsplitsingen op voor een afwezigheidsperiode Vereist bevestiging: Nee Parameters:

  • id (TEKST, Verplicht): De ID van de afwezigheidsperiode

  • limit (NUMMER, Optioneel): Aantal uitsplitsingsdagen dat geretourneerd wordt (1-28, standaard: 28)

  • cursor (TEKST, Optioneel): Paginatie-cursor voor de volgende pagina met resultaten

Uitvoer: Geeft dagelijkse uitsplitsingen terug voor de afwezigheidsperiode


Get verloftypes

personio.gettimeofftypes

Haal alle beschikbare verloftypes op Vereist bevestiging: Nee Parameters:

  • limit (NUMMER, Optioneel): Maximum aantal afwezigheidstypen dat geretourneerd wordt (1-100, standaard: 100)

  • cursor (TEKST, Optioneel): Paginatie-cursor voor de volgende pagina met resultaten

Uitvoer: Geeft een lijst terug van verloftypes


Get afwezigheidstype

personio.getabsencetype

Haalt een afwezigheidstype op via ID Vereist bevestiging: Nee Parameters:

  • id (TEKST, Verplicht): De ID van het afwezigheidstype (UUID-formaat)

Uitvoer: Geeft de specifieke afwezigheidstypegegevens terug


Documenten weergeven

personio.listdocuments

Geeft de metadata weer van documenten die behoren tot de opgegeven eigenaar-ID Vereist bevestiging: Nee Parameters:

  • owner_id (TEKST, Verplicht): De ID van de eigenaar van de documenten

  • category_id (TEKST, Optioneel): De ID van de categorie waartoe de documenten behoren

  • created_at_gte (TEKST, Optioneel): Filter documenten gemaakt op of na deze datum (JJJJ-MM-DD)

  • created_at_lt (TEKST, Optioneel): Filter documenten gemaakt vóór deze datum (JJJJ-MM-DD)

  • limit (NUMMER, Optioneel): Aantal documenten dat geretourneerd wordt (1-200, standaard: 100)

  • cursor (TEKST, Optioneel): Paginatie-cursor voor de volgende pagina met resultaten

Uitvoer: Geeft een lijst terug van documenten


Document verwijderen

personio.deletedocument

Verwijdert een document met de opgegeven document-ID Vereist bevestiging: Ja Parameters:

  • document_id (TEKST, Verplicht): De ID van het document dat verwijderd moet worden

Uitvoer: Bevestiging van verwijdering


Lijst met vergoedingen

personio.listcompensations

Geeft loonvergoedingen terug inclusief salaris, uurloon, eenmalig, terugkerend en bonussen Vereist bevestiging: Nee Parameters:

  • start_date (TEKST, Optioneel): Begindatum voor vergoedingen (JJJJ-MM-DD). Duur met end_date moet ≤ 1 maand zijn

  • end_date (TEKST, Optioneel): Einddatum voor vergoedingen (JJJJ-MM-DD). Duur met start_date moet ≤ 1 maand zijn

  • person_id (TEKST, Optioneel): Filter op één of meer persoon-IDs (komma-gescheiden voor meerdere)

  • legal_entity_id (TEKST, Optioneel): Filter op één of meer rechtspersoon-IDs (komma-gescheiden voor meerdere)

  • limit (NUMMER, Optioneel): Aantal vergoedingen dat per pagina wordt geretourneerd (1-100, standaard: 100)

  • cursor (TEKST, Optioneel): Paginatie-cursor voor de volgende pagina met resultaten

Uitvoer: Geeft een lijst terug van vergoedingen


Zoek persoon op e-mail

personio.searchpersonbyemail

Vind een persoon op basis van hun e-mailadres Vereist bevestiging: Nee Parameters:

  • email (TEKST, Verplicht): Het e-mailadres van de werknemer waarnaar gezocht wordt

Uitvoer: Geeft de persoonsgegevens terug als deze gevonden is


Get verlofsaldo

personio.gettimeoffbalance

Krijg het verlofsaldo voor een persoon Vereist bevestiging: Nee Parameters:

  • employeeId (TEKST, Verplicht): De unieke identifier van de werknemer

Uitvoer: Geeft de verlofsaldogegevens terug


Get aangepaste attributen

personio.getcustomattributes

Haal de lijst op van aangepaste attributen die in Personio zijn gedefinieerd Vereist bevestiging: Nee Parameters: Geen

Uitvoer: Geeft een lijst terug van aangepaste attributen


Lijst met sollicitaties

personio.listapplications

Krijg een lijst met wervingsaanvragen met optionele filters Vereist bevestiging: Nee Parameters:

  • limit (NUMMER, Optioneel): Aantal sollicitaties dat geretourneerd wordt (1-200, standaard: 100)

  • cursor (TEKST, Optioneel): Paginatie-cursor voor de volgende pagina met resultaten

  • updated_at_lt (TEKST, Optioneel): Retourneer sollicitaties bijgewerkt vóór deze datum/tijd (ISO 8601-formaat). Niet te gebruiken met ‘Bijgewerkt na’

  • updated_at_gt (TEKST, Optioneel): Retourneer sollicitaties bijgewerkt na deze datum/tijd (ISO 8601-formaat). Niet te gebruiken met ‘Bijgewerkt vóór’

  • candidate_email (TEKST, Optioneel): Filter sollicitaties op kandidaat-e-mailadres

Uitvoer: Geeft een lijst terug van wervingsaanvragen


Get sollicitatie

personio.getapplication

Haal een wervingsaanvraag op via ID Vereist bevestiging: Nee Parameters:

  • id (TEKST, Verplicht): De unieke identifier van de aanvraag

Uitvoer: Geeft de specifieke aanvraaggegevens terug


Get sollicitatie stadiumovergangen

personio.getapplicationstagetransitions

Haal de geschiedenis van stadiumovergangen op voor een wervingsaanvraag Vereist bevestiging: Nee Parameters:

  • id (TEKST, Verplicht): De unieke identifier van de aanvraag

Uitvoer: Geeft de geschiedenis van stadiumovergangen terug


Lijst met kandidaten

personio.listcandidates

Krijg een lijst met wervingskandidaten met optionele filters Vereist bevestiging: Ja Parameters:

  • limit (NUMMER, Optioneel): Aantal kandidaten dat geretourneerd wordt (1-200, standaard: 100)

  • cursor (TEKST, Optioneel): Paginatie-cursor voor de volgende pagina met resultaten

  • updated_at_lt (TEKST, Optioneel): Retourneer kandidaten bijgewerkt vóór deze datum/tijd (ISO 8601-formaat). Niet te gebruiken met ‘Bijgewerkt na’

  • updated_at_gt (TEKST, Optioneel): Retourneer kandidaten bijgewerkt na deze datum/tijd (ISO 8601-formaat). Niet te gebruiken met ‘Bijgewerkt vóór’

  • email (TEKST, Optioneel): Filter kandidaten op e-mailadres

Uitvoer: Geeft een lijst terug van wervingskandidaten


Get kandidaat

personio.getcandidate

Haal een wervingskandidaat op via ID Vereist bevestiging: Ja Parameters:

  • id (TEKST, Verplicht): De unieke identifier van de kandidaat

Uitvoer: Geeft de specifieke kandidaatgegevens terug


Lijst met vacatures

personio.listjobs

Krijg een lijst met wervingsvacatures met optionele filters Vereist bevestiging: Nee Parameters:

  • limit (NUMMER, Optioneel): Aantal vacatures dat geretourneerd wordt (1-200, standaard: 100)

  • cursor (TEKST, Optioneel): Paginatie-cursor voor de volgende pagina met resultaten

  • updated_at_lt (TEKST, Optioneel): Retourneer vacatures bijgewerkt vóór deze datum/tijd (ISO 8601-formaat). Niet te gebruiken met ‘Bijgewerkt na’

  • updated_at_gt (TEKST, Optioneel): Retourneer vacatures bijgewerkt na deze datum/tijd (ISO 8601-formaat). Niet te gebruiken met ‘Bijgewerkt vóór’

Uitvoer: Geeft een lijst terug van wervingsvacatures


Get vacature

personio.getjob

Haal een wervingsvacature op via ID Vereist bevestiging: Nee Parameters:

  • id (TEKST, Verplicht): De unieke identifier van de vacature

Uitvoer: Geeft de specifieke vacaturegegevens terug


Lijst met vacaturecategorieën

personio.listjobcategories

Krijg alle vacaturecategorieën voor werving Vereist bevestiging: Nee Parameters: Geen

Uitvoer: Geeft een lijst terug van vacaturecategorieën


Get vacaturecategorie

personio.getjobcategory

Haal een vacaturecategorie op via ID Vereist bevestiging: Nee Parameters:

  • id (TEKST, Verplicht): De unieke identifier van de vacaturecategorie

Uitvoer: Geeft de specifieke vacaturecategoriegegevens terug


Lijst met kostenplaatsen

personio.listcostcenters

Krijg een lijst met kostenplaatsen met filtering, sortering en paginatie Vereist bevestiging: Ja Parameters:

  • id (TEKST, Optioneel): Filter op één of meer kostenplaats-IDs (komma-gescheiden)

  • name (TEKST, Optioneel): Filter op één of meer kostenplaatsnamen (komma-gescheiden)

  • sorteren (TEKST, Optioneel): Sorteer resultaten op veld. Gebruik veldnaam voor oplopend (bijv. ‘name’) of minteken voor aflopend (bijv. ‘-name’). Opties: id, -id, name, -name

  • limit (NUMMER, Optioneel): Aantal kostenplaatsen dat geretourneerd wordt (1-100, standaard: 50)

  • cursor (TEKST, Optioneel): Paginatie-cursor voor de volgende pagina met resultaten

Uitvoer: Geeft een lijst terug van kostenplaatsen


Lijst met werkplekken

personio.listworkplaces

Krijg een lijst met werkplekken met filtering, sortering en paginatie Vereist bevestiging: Nee Parameters:

  • id (TEKST, Optioneel): Filter op één of meer werkplek-IDs (komma-gescheiden)

  • name (TEKST, Optioneel): Filter op één of meer werkplek-namen (komma-gescheiden)

  • sorteren (TEKST, Optioneel): Sorteer resultaten op veld. Gebruik veldnaam voor oplopend (bijv. ‘name’) of minteken voor aflopend (bijv. ‘-name’). Opties: id, -id, name, -name

  • limit (NUMMER, Optioneel): Aantal werkplekken dat geretourneerd wordt (1-100, standaard: 50)

  • cursor (TEKST, Optioneel): Paginatie-cursor voor de volgende pagina met resultaten

Uitvoer: Geeft een lijst terug van werkplekken


Veelvoorkomende gebruikssituaties

  • Data Management Beheer en organiseer uw Personio-gegevens

  • Automatisering Automatiseer workflows met Personio

  • Rapportage Genereer inzichten en rapporten

  • Integratie Verbind Personio met andere tools

Beste praktijken

1

Aan de slag

  • Schakel de Personio-integratie in uw workspace-instellingen in

  • Authenticeer met API-sleutel

  • Test de verbinding met een eenvoudige leesbewerking

  • Verken beschikbare acties voor uw gebruikssituatie

2

Belangrijke overwegingen

  • Zorg voor de juiste authenticatiegegevens

  • Respecteer rate limits en API-quotums

  • Controleer instellingen voor gegevensprivacy

  • Test bewerkingen eerst in een veilige omgeving

Probleemoplossing

Authenticatie mislukt

Verifieer uw API-sleutelreferenties.

Rate limit overschreden

Verminder de verzoekfrequentie.

Gegevens niet gevonden

Controleer machtigingen en beschikbaarheid van gegevens.

Verbindingstime-out

Controleer netwerkconnectiviteit.

Ondersteuning

Voor extra hulp met de Personio-integratie, neem contact op met [email protected]

Gerelateerde integraties