Skip to main content
Go to Integrations ↗ · Opens the webapp — please log in first We know what a hassle it is to keep multiple tools up to date, track status changes of your employees in your main HR-Management Solution and also keep them updated in the Honestly Application. We constantly add new integrations and we are happy to receive feedback from you about the next solution we should integrate with. How to connect
To sync your employee data with Honestly, we need access through Personio’s Employee Data API. To do this, simply navigate to the “Menu” in our tool and select the “Integration” item. Bildschirmfoto 2021-09-07 um 14.44.45 Bildschirmfoto 2021-09-07 um 14.45.00 The next step is to create a new access API in your Personio account. To do this, go to your settings and search API access data.\ Now you need to configure the API\ in this step you give it read permissions and define which attributes will be sent to our system. Name* Last name* Email* Department* Gender Position Supervisor and many more Employees who are created in Personio but have not started to work at your company yet will not be added to the Honestly account (Hire Date must be whitelisted for this) The more attributes you use, the more effectively you can distribute surveys to specific groups later. *marked attributes are mandatory fields and must be released for the system
all other attributes are optional but will help you to improve the evaluation.

If you have now marked all employee attributes you would like to have in our system,
a client ID and a secret code will be generated. Now go back to the Honestly System and click on “Connect”.\ Bildschirmfoto 2021-09-07 um 14.47.22 Now copy the generated Client-ID into the provided tab as well as the Secret-Key,
now both systems should configure with each other. Your employees should have been transferred from Personio with the attributes you provided, and any changes that are now made in Personio - adding/removing employees, changing departments or positions will now be automatically adjusted in our system.
If only the label of a value changes, such as a name after marriage, rename the value in Honestly first under Employees → Attribute Management and only then change it in Personio. Otherwise the sync creates a second value and the survey history is split across the two. See How do I change an attribute value without losing comparability?
When employees are no longer sent from the Personio API (e.g. when they leave the company temporarily or permanently), they are also deleted in the Honestly account (termination date and status should be whitelisted for this ideally). Feedbacks given by the deleted employees in the past will remain in the account. Synchronization runs every 12 hours and updates all employee and group information you provide through the API. When importing, Personio sends the language for each employee, which is set as the default during the integration setup. This language is then assigned to the employees. Once this language has been changed for employees that already exist in Honestly, the following rule applies: “Existing language is retained.” In practice, this means: If you have manually adjusted the language of employees that were sent from Personio before, this language will be retained for these existing employees. Should you encounter any problems when setting up the system, please contact your responsible Customer Success Manager (CSM) and we will assist you.

​
Add a new attribute later

If you create a new attribute in Personio after the integration is set up, Honestly does not pick it up automatically. The synchronization only fills attributes that already exist in Honestly. To add a new attribute:
  1. Create the attribute in Personio and tick it under Settings → API credentials in the readable employee attributes.
  2. In Honestly, go to Employees → Attribute Management and click Add to create an attribute. The attribute name must match the name in Personio exactly, including upper and lower case. Personio sends standard fields with their English name (e.g. Department) and custom fields with the name you gave them in Personio.
  3. Start the synchronization under Integrations with Import on the Personio card, or wait for the next automatic run.
Honestly creates the values as options during the import, so you do not need to enter them in advance. You can find more about attributes in What are attributes and how are they used?
Without step 2, the import still reports Successful import and the new attribute is skipped without any warning. You do not need to disconnect and reconnect the integration.