- Persoon en dienstverband: Creëer en update medewerkers, beheer contracten, cost-centers en afdelingen via dedicated services.
- Aanwezigheid en verzuim: Registreer attendance-periodes, beheer verzuim-typen en periodes voor verlof en ziekte.
- Recruiting: Importeer sollicitaties vanuit externe ATS'en en volg kandidaten door het sollicitatieproces.
- Payroll en documenten: Koppel loonadministratie-services en beheer arbeidscontract-documenten.
- Webhooks en rapportage: Configureer webhook-subscriptions voor data-wijzigingen en haal standaard-rapporten op.
Menu
Personio
Personio is een Duits HR-platform (HRIS) voor het MKB met een brede dekking van personeelsadministratie, verzuim, aanwezigheid, sollicitaties en loonadministratie. Via de REST API v2 koppel je medewerkergegevens, contracten en verzuim aan je payroll-tool, IT-provisioning of BI-systeem. Authenticatie verloopt met een credentials-gebaseerde OAuth 2.0-flow. Webhooks leveren events voor data-wijzigingen, zodat downstream-systemen direct op HR-updates kunnen reageren.
Samenvatting van de Personio API
De Personio v2 API biedt gestructureerde toegang tot het volledige HR-platform via 16 afzonderlijke OpenAPI-specs per service. Hiermee automatiseer je employee-lifecycle, verzuim- en aanwezigheidsregistratie en sollicitatie-pipelines.
API Quick Facts REST
- Authenticatie OAuth2, API Key
- Methods GET (40)DELETE (7)PATCH (7)POST (13)
- Rate limits Standaard rate limits per tenant; configureerbaar per contract
- Webhooks Beschikbaar
- Sandbox Niet beschikbaar
- Response format JSON
- Versionering URL-based
Laatste ontwikkelingen bij de Personio API
Personio werd in 2015 opgericht in München en richt zich specifiek op HR voor het MKB-segment. De eerste REST API v1 verscheen rond 2017 als monolithische API met OAuth 2.0-authenticatie. In 2022 werd v2 gelanceerd met een fundamenteel andere architectuur: 16 afzonderlijke micro-service-APIs met eigen OpenAPI-specs (persons, employment, absence, attendance, recruiting, etc.). Deze opsplitsing maakt het mogelijk om services onafhankelijk te versioneren en uit te breiden. In 2023 zijn webhook-endpoints toegevoegd voor realtime-events. De API is onder actieve doorontwikkeling met focus op internationale payroll-integraties.
API versies
v2 Webhooks Major release
1 juni 2023 Toevoeging van webhook-configuration-service voor realtime events op data-wijzigingen.
API v2 (micro-services) Major release
1 maart 2022 Herstructurering naar 16 afzonderlijke OpenAPI-specs per domein voor onafhankelijke versioning.
API v1 Major release
1 januari 2017 Eerste publieke REST API voor contactsync en verzuim.
Documentatie & resources
Integraties
Populaire koppelingen met Personio
Drie categorieën software waarmee Personio vaak gekoppeld wordt.
Kies voor een kopzorg minder
Stop met handwerk en laat professionals het goed automatiseren!
Een koppeling laten bouwen is binnen handbereik, op maat en precies zoals je wilt