Personio API Directory

Personio is a comprehensive cloud-based HR software tailored specifically for small and medium-sized enterprises (SMEs) aiming to streamline and automate their HR processes. This robust platform offers a suite of tools designed to enhance HR management, recruitment, performance management, and time management. By centralizing employee data, Personio enables businesses to efficiently track attendance, manage payroll, oversee job postings, and handle applicant tracking. Additionally, it facilitates performance reviews and the management of working hours and leave requests, making it an invaluable asset for companies seeking to digitize their HR operations and minimize administrative burdens.

One of the standout features of Personio is its ability to integrate seamlessly with other systems through the Personio API. This integration capability allows businesses to connect Personio with various third-party applications, enhancing the software's functionality and ensuring a smooth flow of data across platforms. By leveraging the Personio API, companies can customize their HR processes to better fit their unique needs, further optimizing their HR management and operational efficiency.

Key highlights of Personio APIs

• 1. Easy Data Access:
  • Seamlessly read and write company, census, and payroll data, including deductions and benefits contributions.
• 2. Automation:
  • Supports automated data transfer to streamline administrative processes and reduce manual data entry.
• 3. Custom Integration:
  • Open API allows for easy integration with other software solutions, connecting existing systems with Personio.
• 4. Third-Party Integrations:
  • Integrates with applications like Xero and DATEV for effortless data transfer and enhanced HR processes.
• 5. Unified API via Merge:
  • Connects products with Personio and other applications to help businesses close more deals and retain customers.
• 6. Scalable:
  • Designed to support companies with 10 to 2000 employees, offering scalability as business needs grow.
• 7. Developer-Friendly:
  • Enables the creation of automations, scripts, and applications to enhance HR processes.

Personio API Endpoints

Absence Periods

• POST https://api.personio.de/v1/company/absence-periods : Create an Absence Period
• DELETE https://api.personio.de/v1/company/absence-periods/{id} : Delete Absence Period by ID

Attendances

• POST https://api.personio.de/v1/company/attendances : Create an Attendance
• GET https://api.personio.de/v1/company/attendances/projects : List Projects
• PATCH https://api.personio.de/v1/company/attendances/projects/{id} : Update Project by ID
• PATCH https://api.personio.de/v1/company/attendances/{id} : Update Attendance by ID

Custom Reports

• GET https://api.personio.de/v1/company/custom-reports/columns : List Custom Report Column Labels
• GET https://api.personio.de/v1/company/custom-reports/reports : List Custom Reports
• GET https://api.personio.de/v1/company/custom-reports/reports/{report_id} : Get Custom Report by ID

Documents

• GET https://api.personio.de/v1/company/document-categories : List Document Categories
• POST https://api.personio.de/v1/company/documents : Upload Document for Company Employees

Employees

• GET https://api.personio.de/v1/company/employees : List Company Employees
• GET https://api.personio.de/v1/company/employees/attributes : List Allowed Employee Attributes
• GET https://api.personio.de/v1/company/employees/custom-attributes : List Allowed Custom Attributes
• GET https://api.personio.de/v1/company/employees/{employee_id} : Get Employee by ID
• GET https://api.personio.de/v1/company/employees/{employee_id}/absences/balance : Get Absence Balance for Employee
• GET https://api.personio.de/v1/company/employees/{employee_id}/profile-picture/{width} : Get Employee Profile Picture

Time-Off

• GET https://api.personio.de/v1/company/time-off-types : List Time-Off Types
• POST https://api.personio.de/v1/company/time-offs : Create a Time-Off
• DELETE https://api.personio.de/v1/company/time-offs/{id} : Delete Time-Off by ID

Recruiting

• POST https://api.personio.de/v1/recruiting/applications : Create Applications in Personio
• POST https://api.personio.de/v1/recruiting/applications/documents : Upload Documents to Applications

Open Positions

• GET https://api.personio.de/xml : Retrieve Open Positions

Personio API FAQs

How do I generate API credentials in Personio?

• Answer: To generate API credentials in Personio:some text
  1. Navigate to Settings > Integrations > API Credentials.
  2. Click on Generate new credentials.
  3. Select the desired scopes and readable attributes for the API key.
  4. Save the generated client_id and client_secret securely.
• Source: Generate and manage API credentials - Personio

What authentication method does the Personio API use?

• Answer: The Personio API uses OAuth 2.0 for authentication. After obtaining your client_id and client_secret, you can request an access token by making a POST request to the authentication endpoint. This token must be included in the Authorization header of your subsequent API requests.
• Source: Get started with Personio API - Personio Developer Hub

Are there rate limits for the Personio API?

• Answer: Yes, Personio enforces rate limits to ensure fair usage:some text
  • Documents and Applications Endpoints: Limited to 20 requests per 60 seconds per company.
  • Other Endpoints: Specific rate limits are not publicly documented; it's recommended to implement error handling for potential 429 Too Many Requests responses.
• Source: Introduction - Personio Developer Hub

Can I retrieve employee data using the Personio API?

• Answer: Yes, you can retrieve employee data by making a GET request to the /v1/company/employees endpoint. Ensure that the desired employee attributes are whitelisted in your API credentials settings to access them via the API.
• Source: List Employees - Personio Developer Hub

Does the Personio API support webhooks?

• Answer: Yes, Personio supports webhooks for specific events, such as when an employee's profile is created, updated, or deleted. You can configure webhooks to receive real-time notifications for these events.
• Source: Personio Developer Hub

‍

Get Started with Personio API Integration

For quick and seamless integration with Personio API, Knit API offers a convenient solution. It’s AI powered integration platform allows you to build any Personio API Integration use case. By integrating with Knit just once, you can integrate with multiple other CRMs, HRIS, Accounting, and other systems in one go with a unified approach. Knit takes care of all the authentication, authorization, and ongoing integration maintenance. This approach not only saves time but also ensures a smooth and reliable connection to Personio API.‍

To sign up for free, click here. To check the pricing, see our pricing page.