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.

Activate from the Marketplace: We have improved the activation flow for this integration. You can now start the activation from the Marketplace. For more information, visit our article Activate Integrations from the Marketplace.


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.

You need to generate new API credentials for this integration in Personio at Settings > API credentials. In most cases, when selecting an integration in the drop-down menu, the system automatically preselects the system attributes that need to be read or written by the integration. You can always add or remove attributes manually if they are needed, or you wish to do so. For more information on how to do this, have a look at our help center article on how to generate and manage API credentials.

The following credentials are required:

  • Personio Client ID
  • Personio Client Secret
  • Sync start date (i.e. from which date should the absences be synced?)

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: 

  • Sickness
  • 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
  • Holiday
  • 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?

The HQ team is happy to help you with any questions about HQ. Contact the team at support@hellohq.io or directly via the live chat on the HQ website (weekdays from 9am-6pm).




Article is closed for comments.

    Topics of this article