--- title: Personio API Integration on Truto slug: personio category: HRIS canonical: "https://truto.one/integrations/detail/personio/" --- # Personio API Integration on Truto **Category:** HRIS **Status:** Generally available ## Unified APIs ### Unified HRIS API - **Employees** — Represents an employee in HRIS - **Timeoff Balances** — Represent the time off balances for an Employee - **Timeoff Requests** — Represent the time off requests for an Employee - **Timeoff Types** — Represent the time off types in a company ## How it works 1. **Link your customer's Personio account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Personio.** The Proxy API is a 1-to-1 mapping of the Personio API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Automate employee provisioning and deprovisioning across your platform** — SaaS companies offering identity, security, or IT management tools can sync Personio's employee lifecycle events to automatically create or disable user accounts. This eliminates manual onboarding steps and closes security gaps when employees leave. - **Sync approved time-off data into scheduling and workforce tools** — Workforce management and shift-scheduling SaaS products can pull approved absences from Personio to automatically block unavailable dates, preventing scheduling conflicts and reducing manual coordination between HR and operations teams. - **Power leave management features with real-time PTO balances** — HR chatbots, employee experience platforms, and leave management tools can read time-off balances and submit new time-off requests back to Personio, giving employees a seamless self-service experience without leaving your product. - **Enrich expense and finance workflows with employee data** — Expense management and corporate card platforms can use Personio employee records — including department, role, and employment status — to auto-issue cards, set spending policies, and instantly freeze access when an employee is terminated. - **Trigger compliance and training workflows on employee hire** — LMS and compliance SaaS products can detect new hires via the Employees endpoint, auto-enroll them in mandatory training programs, and assign courses based on department or role attributes pulled from Personio. ## What you can build - **Automatic user provisioning from Personio employee records** — Detect new employees and terminated employees in Personio and automatically create, update, or deactivate corresponding user accounts in your platform. - **Absence-aware scheduling calendar** — Pull approved time-off requests from Personio and reflect them as blocked dates in your scheduling UI so managers never accidentally assign unavailable staff. - **In-app PTO request submission with balance checks** — Show employees their remaining leave balances from Personio and let them submit new time-off requests directly from your product, routed back to Personio for manager approval. - **Department-based policy engine powered by HR data** — Use employee attributes like department, role, and seniority from Personio to dynamically assign permissions, spending limits, or access tiers within your application. - **Real-time employee directory sync** — Keep an always-current employee directory inside your product by continuously syncing employee profiles — names, emails, departments, and employment status — from Personio. - **Onboarding workflow trigger for new hires** — Automatically kick off onboarding tasks in your platform — training assignments, equipment requests, or welcome flows — the moment a new employee record appears in Personio. ## FAQs ### What authentication method does the Personio integration use? Personio's API uses API key-based authentication. The Personio admin generates a client ID and client secret in their Personio settings, which are exchanged for a bearer token. Truto handles this token exchange and refresh automatically. ### Why might some employee fields come back empty from Personio? Personio requires the admin to explicitly whitelist which employee attributes (e.g., department, hire date, salary) the API key can access. If a field isn't whitelisted in Personio's settings wizard, it won't be returned by the API. Your end users need to be guided to enable the correct attribute permissions during setup. ### What Unified API resources are available for Personio through Truto? Personio is supported through Truto's Unified HRIS API, which covers Employees, Timeoff Balances, Timeoff Requests, and Timeoff Types. These map to Personio's employees and absences endpoints. ### Does Personio support webhooks for real-time data syncing? Yes. Personio supports webhooks for employee created, updated, and deleted events. This allows your integration to react to changes in real time rather than relying solely on polling. ### Can I write data back to Personio, or is it read-only? Personio's API supports both read and write operations. Employees can be created and updated, and time-off requests (absences) can be created and deleted. Through Truto's Unified HRIS API, you can submit new time-off requests that route to the manager for approval inside Personio. ### What if I need Personio data beyond what the Unified HRIS API covers, like attendances or custom endpoints? Truto can build additional tools and proxy endpoints for Personio on request. If you need access to attendances (timesheets), custom attributes, or other Personio-specific resources not yet in the Unified API, reach out to the Truto team to scope it.