Personio

Personio (via Apideck)

Access Personio through Apideck's HRIS unified API — one of 58 HRIS connectors that share the same method surface. Code you write here ports to BambooHR, Workday, Deel and 54 other HRIS connectors by changing a single serviceId string. Apideck handles auth, pagination, rate limiting, and retries so you don't write per-tenant Personio plumbing.

Quick facts

• Apideck serviceId: personio
• Unified API: HRIS
• Auth type: oauth2
• Apideck setup guide: Connection guide
• Gotchas: page
• Personio docs: https://developer.personio.de
• Homepage: https://www.personio.com/

When to use this skill

Activate this skill when the user explicitly wants to work with Personio — for example, "sync employees in Personio" or "list time-off requests in Personio". This skill teaches the agent:

1. Which Apideck unified API covers Personio (HRIS)
2. The correct serviceId to pass on every call (personio)
3. Personio-specific auth and coverage caveats

For the full method surface (parameters, pagination, filtering), use your language SDK skill:

• apideck-node, apideck-python, apideck-dotnet, apideck-java, apideck-go, apideck-php, or apideck-rest

For the raw OpenAPI spec:

• HRIS: https://specs.apideck.com/hris.yml · API Explorer

Minimal example (TypeScript)

import { Apideck } from "@apideck/unify";

const apideck = new Apideck({
  apiKey: process.env.APIDECK_API_KEY,
  appId: process.env.APIDECK_APP_ID,
  consumerId: "your-consumer-id",
});

// List employees in Personio
const { data } = await apideck.hris.employees.list({
  serviceId: "personio",
});

Portable across 58 HRIS connectors

The Apideck HRIS unified API exposes the same methods for every connector in its catalog. Switching from Personio to another HRIS connector is a one-string change — no rewrite, no new SDK.

// Today — Personio
await apideck.hris.employees.list({ serviceId: "personio" });

// Tomorrow — same code, different connector
await apideck.hris.employees.list({ serviceId: "bamboohr" });
await apideck.hris.employees.list({ serviceId: "workday" });

This is the compounding advantage of using Apideck over integrating Personio directly: code against the unified HRIS API once, gain access to every connector in it. New connectors Apideck adds become available to your app without code changes.

Personio via Apideck HRIS

Personio is a European SMB HRIS. Apideck currently covers employees and time-off requests.

Entity mapping

Coverage highlights

• ✅ Full employee list + details (51+ fields surfaced)
• ✅ Time-off request lifecycle (read, approve, reject)
• ⚠️ Departments/offices — derived from employee fields, not first-class
• ❌ Performance reviews, training — use Proxy

Always check /connector/connectors/personio for current coverage.

Auth

• Type: API credentials (client ID + client secret), managed by Apideck Vault
• Region: Personio's API is region-sharded (EU). All accounts share the same base URL.
• Permissions: API credentials inherit the configured role. Admin credentials recommended for full sync.

Example: list all employees with custom fields

const { data } = await apideck.hris.employees.list({
  serviceId: "personio",
  fields: "id,first_name,last_name,email,department,custom_fields",
});

Escape hatch: Proxy API

When an endpoint isn't covered by the HRIS unified API, use Apideck's Proxy to call Personio directly — Apideck injects auth headers and handles token refresh. Set x-apideck-downstream-url to the target endpoint on Personio's own API:

curl 'https://unify.apideck.com/proxy' \
  -H "Authorization: Bearer ${APIDECK_API_KEY}" \
  -H "x-apideck-app-id: ${APIDECK_APP_ID}" \
  -H "x-apideck-consumer-id: ${CONSUMER_ID}" \
  -H "x-apideck-service-id: personio" \
  -H "x-apideck-downstream-url: <target endpoint on Personio>" \
  -H "x-apideck-downstream-method: GET"

See Personio's API docs for available endpoints.

Sibling connectors

Other HRIS connectors that share this unified API surface (same method signatures, just change serviceId):

bamboohr, workday, deel (beta), hibob, adp-ihcm (beta), adp-workforce-now (beta), paychex (beta), paylocity, and 49 more.

See also

• Apideck connection guide for Personio
• HRIS OpenAPI spec · API Explorer
• apideck-connector-coverage — programmatic coverage checks
• apideck-best-practices — architecture, Vault, pagination, error handling
• apideck-node — TypeScript / Node SDK patterns
• Personio official docs