{
 "categories": [
  "hr",
  "hcm"
 ],
 "deployment": "saas",
 "evidence": [
  {
   "date": "2026-09-02",
   "fact": "homepage",
   "note": "Personio's Developer Hub presents Personio as an HR platform with public APIs for integrations and automations, and states the marketplace reaches 10,000-plus businesses. The marketing site at personio.com was bot-walled in this pass.",
   "source": "https://developer.personio.de/",
   "tier": "declared"
  },
  {
   "date": "2026-09-02",
   "fact": "license",
   "note": "Personio is sold as commercial SaaS. Custom public-API integrations require the Core Pro plan; the credentials article points administrators to Subscription & billing to confirm that plan.",
   "source": "https://support.personio.de/hc/en-us/articles/4404623630993-Generate-and-manage-API-credentials",
   "tier": "declared"
  },
  {
   "date": "2026-09-02",
   "fact": "modalities.api.exists",
   "note": "Personio documents a public API for Employee, Attendance, Absence, Recruiting, Custom Reports, and Webhook endpoints, hosted from the Developer Hub.",
   "source": "https://developer.personio.de/docs/getting-started-with-the-personio-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-02",
   "fact": "modalities.api.kinds[0]",
   "note": "The documented interface is HTTPS REST. Examples include GET/POST/PATCH on employees and POST https://api.personio.de/v1/auth or v2 token and resource paths.",
   "source": "https://developer.personio.de/docs/getting-started-with-the-personio-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-02",
   "fact": "modalities.api.auth[0]",
   "note": "Personio documents POST https://api.personio.de/v2/auth/token as an OAuth 2.0 client-credentials grant. Required fields are grant_type=client_credentials, client_id, and client_secret. The response is a Bearer access_token with expires_in default 86400 seconds.",
   "source": "https://developer.personio.de/reference/post_v2-auth-token",
   "tier": "declared"
  },
  {
   "date": "2026-09-02",
   "fact": "modalities.api.auth[1]",
   "note": "Personio documents a separate predefined Recruiting API access token per account, retrieved from Marketplace > Connected integrations > Recruiting Integrations, used to GET open positions and POST applications.",
   "source": "https://developer.personio.de/docs/getting-started-with-the-personio-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-02",
   "fact": "modalities.api.coverage",
   "note": "Employees support GET, POST, and PATCH with attribute whitelisting. v1 salary data is mostly unavailable. Attendances support GET, POST, PATCH, DELETE. Absences support GET, POST, DELETE. Custom Reports are GET-only. Recruiting v1 posts applications to published jobs; v2 adds broader recruiting reads.",
   "source": "https://developer.personio.de/docs/getting-started-with-the-personio-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-02",
   "fact": "modalities.api.docs",
   "note": "Opened Personio's current public-API getting-started guide, including credential types, endpoint groups, and the pointer to v2 recruiting methods.",
   "source": "https://developer.personio.de/docs/getting-started-with-the-personio-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-02",
   "fact": "modalities.mcp.first_party",
   "note": "Personio documents a first-party MCP server in beta. The tenant URL is https://yourcompany.app.personio.com/mcp. Setup uses an OAuth Client ID. An Administrator must enable Personio MCP. The article states it is not available for everyone yet.",
   "source": "https://support.personio.de/hc/en-us/articles/38314656674333-Personio-MCP-server-Beta-access-overview",
   "tier": "declared"
  },
  {
   "date": "2026-09-02",
   "fact": "modalities.mcp.verdict",
   "note": "The MCP connector is vendor-hosted and vendor-documented. Tools cover employee profiles, time off, compensation, and performance. Write access is off by default. Personio says the MCP server is not a replacement for the API for permanent integrations.",
   "source": "https://support.personio.de/hc/en-us/articles/38314656674333-Personio-MCP-server-Beta-access-overview",
   "tier": "declared"
  },
  {
   "date": "2026-09-02",
   "fact": "modalities.extensibility.webhooks",
   "note": "Personio documents HTTPS POST webhooks with HMAC-SHA256 signatures. Events include person, employment, absence-period, attendance-period, and document create, update, and delete.",
   "source": "https://developer.personio.de/v2.0/reference/webhooks",
   "tier": "declared"
  },
  {
   "date": "2026-09-02",
   "fact": "modalities.data_access.export",
   "note": "Authenticated employee, attendance, absence, custom-report, and recruiting GET calls return JSON. Custom Reports return report rows formatted in JSON.",
   "source": "https://developer.personio.de/docs/getting-started-with-the-personio-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-02",
   "fact": "modalities.data_access.import",
   "note": "Employee POST/PATCH, attendance POST/PATCH, absence POST, and recruiting application POST create or update Personio records through the public API.",
   "source": "https://developer.personio.de/docs/getting-started-with-the-personio-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-02",
   "fact": "modalities.agent_docs.llms_txt",
   "note": "Personio publishes a genuine Developer Hub llms.txt that indexes getting-started, authentication, v2 persons, compensations, recruiting, webhooks, and changelog pages.",
   "source": "https://developer.personio.de/llms.txt",
   "tier": "declared"
  },
  {
   "date": "2026-09-02",
   "fact": "verdict.scores.api",
   "note": "The public API is documented, read/write on core HR objects, and paired with OAuth client credentials, a recruiting token, and webhooks. Core Pro, attribute whitelists, v1 salary gaps, GET-only reports, and the lack of an established official SDK keep the path below a broad 8.",
   "source": "https://developer.personio.de/docs/getting-started-with-the-personio-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-02",
   "fact": "verdict.scores.mcp",
   "note": "The first-party server is beta, tenant-gated, administrator-enabled, and write-disabled by default. That matches a limited vendor-preview score, not production-grade official coverage.",
   "source": "https://support.personio.de/hc/en-us/articles/38314656674333-Personio-MCP-server-Beta-access-overview",
   "tier": "declared"
  },
  {
   "date": "2026-09-02",
   "fact": "freshness.watch[0].url",
   "note": "Opened Personio's current MCP beta article. It still states beta access, the tenant /mcp URL pattern, OAuth Client ID setup, write tools off by default, and Claude, Antigravity, and VS Code Copilot as supported clients.",
   "source": "https://support.personio.de/hc/en-us/articles/38314656674333-Personio-MCP-server-Beta-access-overview",
   "tier": "declared"
  },
  {
   "date": "2026-09-02",
   "fact": "freshness.watch[1].url",
   "note": "Opened and verified as the current Personio public-API getting-started page for credential types and endpoint groups.",
   "source": "https://developer.personio.de/docs/getting-started-with-the-personio-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-02",
   "fact": "freshness.watch[2].url",
   "note": "Opened and verified as the current v2 OAuth 2.0 client-credentials token endpoint at /v2/auth/token.",
   "source": "https://developer.personio.de/reference/post_v2-auth-token",
   "tier": "declared"
  }
 ],
 "freshness": {
  "last_verified": "2026-09-02",
  "volatility": "high",
  "watch": [
   {
    "type": "mcp",
    "url": "https://support.personio.de/hc/en-us/articles/38314656674333-Personio-MCP-server-Beta-access-overview"
   },
   {
    "type": "docs",
    "url": "https://developer.personio.de/docs/getting-started-with-the-personio-api"
   },
   {
    "type": "docs",
    "url": "https://developer.personio.de/reference/post_v2-auth-token"
   }
  ]
 },
 "homepage": "https://developer.personio.de/",
 "id": "personio",
 "license": "commercial",
 "modalities": {
  "agent_docs": {
   "llms_txt": true
  },
  "api": {
   "auth": [
    "client-credentials",
    "recruiting-token"
   ],
   "coverage": "partial",
   "docs": "https://developer.personio.de/docs/getting-started-with-the-personio-api",
   "exists": true,
   "kinds": [
    "rest"
   ]
  },
  "cli": {
   "exists": "unknown"
  },
  "computer_use": {
   "issues": [],
   "viability": "unknown"
  },
  "data_access": {
   "export": [
    "api-json"
   ],
   "import": [
    "api-json"
   ]
  },
  "extensibility": {
   "scripting": [],
   "webhooks": true
  },
  "integrations": {
   "make": "unknown",
   "n8n": "unknown",
   "power_automate": "unknown",
   "zapier": "unknown"
  },
  "mcp": {
   "first_party": true,
   "third_party": [],
   "verdict": "official"
  },
  "rpa": {
   "drivability": "unknown",
   "notes": "No repeatable UI probe was run. The Personio public API, webhooks, and the tenant MCP beta are the supported automation paths. Browser control of the Personio UI remains unassessed.\n",
   "ui_stack": [
    "web-dom"
   ],
   "vendor_support": []
  },
  "sdk": {
   "exists": "unknown",
   "languages": [],
   "official": "unknown"
  }
 },
 "name": "Personio",
 "platforms": [
  "web"
 ],
 "related": {
  "alternatives": [
   "workday",
   "sap-successfactors",
   "simployer",
   "4human-hrm"
  ],
  "our_products": []
 },
 "schema_version": 1,
 "score_version": 1,
 "status": "active",
 "vendor": "Personio",
 "verdict": {
  "best_path": "api",
  "scores": {
   "api": 7,
   "cli": null,
   "computer_use": null,
   "integrations": null,
   "mcp": 5,
   "overall": 7,
   "rpa": null
  },
  "summary": "Personio HR is automatable today through the public Personio API. This record is Personio, not Workday, SAP SuccessFactors, Simployer, or 4human HRM. Custom API credentials require the Core Pro plan and are created under Marketplace > Connected integrations. Personnel calls authenticate with an OAuth 2 client-credentials grant at https://api.personio.de/v2/auth/token using client_id, client_secret, and grant_type=client_credentials. Tokens are Bearer tokens, default lifetime one day. The Recruiting API still uses a separate account-level access token from the credentials section. v1 covers employees, attendances, absences, recruiting job and application posts, custom reports, and webhook administration. v2 adds persons and employments, compensations, documents, org units, and recruiting reads for jobs, candidates, and applications. Coverage is partial: employee attribute reads are whitelisted, v1 does not automatically expose most salary fields, custom reports are GET-only, and recruiting v2 currently omits custom attributes and tags. Personio documents HTTPS webhooks with HMAC-SHA256 signatures for person, employment, absence, attendance, and document events. Personio also documents a first-party tenant MCP server in beta at https://<company>.app.personio.com/mcp. An administrator must enable it; it is not available for every tenant; write tools such as requesting time off are off by default; and Personio says the MCP server is not a replacement for scheduled API integrations. The Developer Hub publishes a genuine llms.txt index. Official SDKs, a Personio CLI, and iPaaS connector status were not established. Computer-use viability is unassessed. API scores 7 and is the best path. MCP scores 5 as a limited vendor preview.\n"
 }
}