Personio Public API v1

REST discovered

Details

URL: https://api.personio.de/v1
Docs: https://developer.personio.de/v1.0/reference/introduction

Authentication

Personio API client credentials oauth2_cc discovered Set up OAuth ↗

api_key=<credential> /Authorization: Bearer <credential>

In a Personio account, go to Settings > API credentials and choose Generate new credentials. Personio issues a client_id and client_secret; use them with the client-credentials token flow at POST /v2/auth/token to obtain a bearer token for non-recruiting APIs. Attribute access and scopes are configured in the credential wizard; for employee data you must whitelist the attributes you want to read. See Get started with Personio API and Generate and manage API credentials.

Personio Recruiting API access token Authorization: Bearer <credential> + Personio Recruiting API access token X-Company-ID: <credential> discovered

Personio Recruiting API access token bearer Get token ↗

In a Personio account, go to Settings > API credentials. Personio states the Recruiting API access token is predefined for each account and can be retrieved directly from the credentials section. Copy that token and send it as a bearer token when calling legacy Recruiting API endpoints. See Get started with Personio API.