Personio integration
Add the transformation layer to your Personio
skaills plugs into Personio via its public REST API. No modifications to your Personio install. No new SSO implementations. Start getting psychometric assessment + growth plans + ESCO career paths on top of the employee data you already have.Three ways to integrate
Pick the depth that fits your needs — start light, grow when ready.
Outbound — skaills enriches Personio
Planned~2-3 weeks for the first connector. No Personio-side custom work beyond defining the necessary custom attributes.
Bidirectional — Personio drives, skaills executes
Planned~5-7 weeks. Requires Personio-side configuration (custom attributes, Personio Workflows webhooks, SAML if SSO).
Personio Marketplace — skaills as listed integration
Roadmap3-5 months including Personio security review, partner-program enrollment, certification.
What this looks like in practice
Concrete flows triggered by events in Personio.
| Trigger in Personio | What skaills does | What flows back to Personio |
|---|---|---|
| New candidate applies to a Personio Recruiting position | skaills generates a sector-specific evaluation link, sends to candidate, computes multi-dimensional score with ESCO tagging on completion | Score + competency profile + link to detailed report appear as custom attributes on the candidate's Personio Recruiting profile |
| Employee flagged for development in Personio Performance & Development cycle | skaills runs AI-Readiness + Career Path Navigator (with ESCO stops) + Personal Growth Plan | Development plan, suggested paths, and learning recommendations populated in the employee's Personio development goals |
| European CHRO launches org-transformation initiative | skaills generates Org Transformation Plan from aggregated Personio data (structure, headcount, country distribution, climate survey) with ESCO framework | CHRO-grade roadmap with ESCO capability heatmap + tracks + KPIs delivered as skaills dashboard, exportable to Personio Workflows as a task sequence |
| Climate survey run in skaills | skaills processes responses (GDPR-compliant, configurable EU residency), computes engagement indices by unit/country, generates recommendations | Engagement metrics appear as department- or segment-level custom attributes in Personio, feeding People Analytics dashboards |
Technical architecture
The integration uses Personio's public REST API (Personio API v1). Authentication via OAuth 2.0 client credentials — skaills operates with a dedicated client-id/client-secret pair from your Personio tenant, with permissions restricted to the agreed endpoints and custom attributes. Data transits via HTTPS (TLS 1.2+); skaills never stores Personio credentials, only short-lived access tokens. For bidirectional integrations, we configure Personio Workflows to emit webhooks toward a dedicated skaills Cloud Function (`personioWebhook`) with signature verification. For European customers requiring strict EU data residency for sensitive data, skaills can be deployed in europe-west1 region under enterprise SLA — aligned with Personio's GDPR model. All skaills-side logic is serverless.
Implementation timeline
1
Week 1
Define which Personio modules are in-scope (Recruiting, Performance, both), which events trigger the flow, which custom attributes we'll create on the Personio side to receive scores, and which data residency applies. Identify sponsor, Personio technical owner, and skaills team.Kickoff and scope
Deliverable:Scope document + custom-attribute list to create, signed by both parties
2
Weeks 2-3
Customer creates the agreed custom attributes in Personio + provisions OAuth 2.0 credentials (client-id/secret) with minimum scopes. skaills configures connector, field mapping, and endpoints. First end-to-end test with a synthetic candidate: applies to a Personio position → skaills evaluation triggers → score injects as custom attribute.Technical setup
Deliverable:E2E test passing with synthetic candidate; technical integration functional
3
Week 4
Deploy to one real recruiting team (or one country unit for multi-country pilot), with 5-15 real candidates flowing through end-to-end. Monitor metrics: completion rate, latency, score quality, recruiter satisfaction, GDPR compliance. 15-minute daily standup to resolve whatever surfaces.Controlled pilot
Deliverable:Pilot report with real-world metrics + GDPR attestation
4
Week 5+
Apply pilot-feedback adjustments, document for your teams (runbook, where to check logs, contact for issues), and extend the flow to your full organization. Gradual activation by country or business unit, with weekly check-ins during the first month. After that, ongoing support at the cadence we agree on (typically monthly).Full rollout
Deliverable:Runbook + integration in production for all in-scope units
For companies with multiple European country footprints, add ~1 week per additional country for local-compliance validation. For Personio Marketplace listing, add 3-5 months for certification.
