Automate onboarding
Create employees and push hires into downstream systems.
PersonioHR Connector
Build in-app HR automations that read and write Personio employee, recruiting and document records, trigger workflows from Personio webhooks and deliver self-serve integrations to customers.
Capture applicants
Post applications and documents from career pages automatically.
Event-driven sync
Use Personio webhooks to trigger tenant-specific workflows.
Embedded experience
Deliver customer-facing workflows natively inside your SaaS product.
CONNECTOR OVERVIEW
What you can integrate with Personio
Integrate and automate employee lifecycle, recruiting applications, documents, time-offs and HR reports in Personio. The connector supports API operations to list and manage employees, create recruiting applications and upload documents, plus webhooks for person and application events. (developer.personio.de)
PRODUCT USE CASES
Use cases you can build with Personio
Create automated onboarding, applicant capture and HR syncs for many customer accounts. Use Personio webhooks to trigger downstream processes and publish prebuilt workflows in an embedded marketplace for customers.
Automated employee provisioning and offboarding
Create and update Personio employee records on hire, update HR systems and revoke access on termination using company/employees endpoints. (developer.personio.de)
Capture career-site applications
POST recruiting applications and upload applicant documents into Personio so candidates land in recruiting pipeline. (developer.personio.de)
Trigger workflows from Personio events
Subscribe to Personio webhooks (person.created, application.updated) to start tenant-specific onboarding or notifications. (developer.personio.de)
ORCHESTRATION
How PersonioHR works with Cyclr
Cyclr sits between your SaaS product and PersonioHR to handle authentication, govern access and orchestrate every API call per customer, at scale.
- 1
Your SaaS product
Your app requests an action for a specific customer.
- 2
Cyclr orchestration
Cyclr authenticates, applies policies and routes the request.
- 3
PersonioHR
PersonioHR processes the request and returns a response to your app.
Customer-specific authentication · Governed data movement · Centralized visibility and audit
CONNECTOR COVERAGE
Available connector capabilities
Explore PersonioHR methods you can orchestrate through Cyclr.
Employees6
List Updated Employees
ActionGets a list of employees since last run.
Get Employee
ActionGets an employee by ID.
List Employees
ActionGets a list of employees.
List New Employees
ActionGets a list of employees created since last run.
Create Employee
ActionCreate an employee.
List Birthday Employees
ActionGets a list of employees whose birthday is the current date, or between two provided dates.
Absences3
List Absence Types
ActionGet a list of available absence types.
List Absences
ActionGet a list of company employee absences.
Create Absence
ActionCreate an absence for company employee.
Attendances4
Create Attendances
ActionCreate attendances for company employees.
List Attendances
ActionGet a list of company employee attendances.
Update Attendances
ActionUpdate an attendance period.
Delete Attendance
ActionDelete attendance data.
TECHNICAL DETAILS
PersonioHR integration and API details
Review the sourced authentication and API behaviour used when configuring customer-facing PersonioHR integrations in Cyclr.
API and authentication
- API host
https://api.personio.de- Authentication
- OAuth 2.0 (Client Credentials)
- Credentials
Client ID and Client Secret; Company ID (X-Company-ID); optional X-Personio-App-ID and X-Personio-Partner-ID. (developer.personio.de)
- Method categories
Personnel; Recruiting; Documents; Time-off; Reports; Webhooks; Auth
Pagination and rate limits
Pagination
Pagination varies by endpoint: many v1 endpoints use limit/offset; some v2 endpoints use cursor pagination. Confirm pagination per endpoint. (developer.personio.de)
Rate limits
Personio enforces rate limits: auth ~60/min; some endpoints (GET employees) 300/min; global v1 limits noted (2000/min); 429 returned on exceed. (developer.personio.de)
IMPLEMENTATION
Authentication at a glance
Personio uses OAuth 2.0 client credentials to obtain bearer tokens; Cyclr Console must be configured to store client ID and secret securely. Confirm enabled option in Cyclr Console. (developer.personio.de)
- Authentication method
- OAuth 2.0 (Client Credentials)
- Credential required
Client ID and Client Secret; Company ID (X-Company-ID); optional X-Personio-App-ID and X-Personio-Partner-ID. (developer.personio.de)
Before you begin:
View setup guideRequires Personio API credentials and company ID; admin permissions needed to create credentials.
COMMON QUESTIONS
Frequently asked questions
It automates employee lifecycle, recruiting applications, document uploads, time-off and HR reports by calling Personio Personnel and Recruiting APIs and handling webhook events. (developer.personio.de)
It uses OAuth 2.0 client credentials: Cyclr stores Client ID and Client Secret and exchanges them for a bearer token via Personio’s auth token endpoint. Tokens are short‑lived; auth endpoint rate limits apply. (developer.personio.de)
Yes. Cyclr can store per-tenant Personio credentials (client id/secret and company id) so each customer account uses its own API credential when running workflows. (developer.personio.de)
Yes. Cyclr orchestration can expose specific Personio API actions as governed MCP tools with role-based controls and reusable flows for product teams. Confirm which Personio methods you want to publish.
KEEP EXPLORING
Related resources and connectors
Documentation
HR Integrations to make your daily tasks easier
Read more →ProductWhat is iPaaS?
Read more →ProductMCP PaaS
Read more →Related connectorBambooHR
Related HR/payroll connector for customer-facing integration workflows.
Related connectorbob HR
Related HR/payroll connector for customer-facing integration workflows.
Related connectorBreathe HR
Related HR/payroll connector for customer-facing integration workflows.