In this article, you will learn how to integrate HQ to Personio. You will get an overview of all the requirements for installation of the integration with the Personio employee data API.
What is HQ?
The agency software HQ covers the entire project process - from Customer Relationship Management (CRM), and project and resource planning to time tracking, billing and controlling. The HQ replaces Excel chaos and isolated applications with a clear, cohesive workflow for a more productive team. The GDPR-compliant all-in-one solution is already in use at more than 700 leading agencies.
How can I set up the integration of HQ and Personio?
To enable the Personio Integration, please contact HQ Support at support@helloHQ.io. The following credentials are required:
- Personio Client ID
- Personio Client Secret
- Sync start date (i.e. from which date should the absences be synced?)
You need to generate new API credentials for this integration in Settings > API credentials. For more information on how to do this, have a look at our help center article on how to generate and manage API credentials. You can choose which personal data the integration can read or write based on the attributes listed in the following points.
With the activation of the integration, absences cannot be edited in HQ (also currently existing ones). Furthermore, no vacations can be requested via HQ and no vacation accounts can be managed.
Mapping of Personio absences to HQ absences
To set up the integration, HQ needs information about which Personio absence should be mapped to which HQ absence. All HQ absences are available for selection:
- Child sick
- Unpaid illness (>6 weeks)
- Overtime compensation - full-day only
- Remote work
- Corporate reasons
- Personal reasons
- Advanced education
- Trade school
- Maternity leave - full-day only
- Parental leave - full-day only
- Unpaid leave
- Special leave
Additional information on mapping absences
- Multiple Personio absences can be mapped to one HQ absence.
- The mapping of absences can be adjusted at any time under admin / settings. There is a system setting for each HQ absence. If several Personio absences are mapped to one HQ absence, these must be entered comma-separated.
- If the mapping is changed later, previously-entered absences will remain unchanged (exception: the absence is edited again in Personio after the change).
In Personio, absences can be entered as half-day or full-day. In case of absences marked as full-day only, all absences in the HQ will automatically be entered as full-day, no matter what is set in Personio.
What data will be transferred?
The integration transfers absences that are recorded in Personio from Personio to HQ. The e-mail addresses of the users in Personio and HQ must match. The absences are then synchronized every 2 hours. Absences that are edited or deleted in Personio are adjusted or deleted accordingly in HQ.
What are the costs?
The price for the HQ depends on the booked plan and the team size (number of licenses booked). Detailed pricing information can be found here.
Who do I contact at HQ?
Can't find what you're looking for?
We are happy to help you! Just write us a message with your questions and we will get back to you as soon as possible.Submit a request