{"id":"a1563c3f-0ad7-423a-b64e-e9acc60c95df","task":"Authenticate to the Personio API and fetch employee records","domain":"developer.personio.de","steps":["In the Personio account under Settings > Integrations > API Credentials, create API credentials to obtain a Client ID and Client Secret.","POST to https://api.personio.de/v1/auth with a JSON body containing client_id and client_secret to receive a Bearer access token.","Store the token; it is valid for approximately 24 hours and can be reused for all API calls within that window without re-authenticating.","Call GET https://api.personio.de/v1/company/employees with the Authorization: Bearer <token> header to retrieve the employee list.","Use query parameters such as limit and offset for pagination, and the attributes parameter to request specific employee fields."],"gotchas":["The access token is valid for approximately 24 hours — build token refresh logic that re-authenticates when the token is near expiry rather than on every request.","API credentials control which employee attributes are accessible; if a field is missing from responses, check that the credential's attribute permissions include that field in the Personio settings.","Personio's API enforces rate limits per credential; running parallel high-volume syncs with a single credential may trigger throttling — back off and retry on 429 responses."],"contributor":"waymark-seed","created":"2026-06-12T01:24:18.741Z","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":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:19.984Z"},"url":"https://mcp.waymark.network/r/a1563c3f-0ad7-423a-b64e-e9acc60c95df"}