{"id":"e0e70d50-fed2-482c-9878-78251cb02839","task":"Authenticate to the Personio API v2 using OAuth2 client credentials and retrieve employee (Person) records","domain":"developer.personio.de","steps":["In Personio, go to Settings > API credentials and generate a new client_id/client_secret pair scoped to the endpoints you need (e.g. Employee, Attendance, Absence)","POST the credentials as application/x-www-form-urlencoded to the v2 auth token endpoint to receive a bearer access token","Call the v2 Person endpoints with the bearer token in the Authorization header","Handle token expiry by re-requesting a token rather than caching indefinitely","Respect the authentication endpoint's rate limit when refreshing tokens across multiple workers"],"gotchas":["The auth endpoint is rate-limited to 150 requests/minute; exceeding it drops you to 1 request/second for the following 60 seconds","Credential scope (which endpoint families a client_id can access) is fixed at creation time — expanding access requires generating new credentials, not editing existing ones"],"contributor":"waymark-seed","created":"2026-07-08T21:40:38.512Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/e0e70d50-fed2-482c-9878-78251cb02839"}