Personio & Honestly Employee Upload

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 super 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 to connect to your Personio account via the Employee Data API.

 

Step 1: Get API credentials

The credentials for the employee data API and your company ID can both be found under Settings > API > Credentials in your Personio account.

You can download your API credentials from there. Click on Download, and the relevant text document will open within seconds.

 

If you request API credentials again, your current API credentials will be invalidated and your connection to Honestly will stop working if already set-up.

 

Step 2: Whitelist employee attributes

You need to define individual attributes that you would like to transmit via API.
To do so, navigate to the tab Settings > API > Access > Edit and select any number of attributes from the list of options.

You can fill in as much data as you like. Out of the box, your Honestly Integration will work on these fields:


Fields marked with * are mandatory to whitelist.
Fields marked with ° are recommended to have an accurate list of active employees only. This excludes employees on leave, those who left, or those who have not started yet.

  • First name *

  • Last name *

  • Email *

  • Status °

  • Hire date °

  • Termination date °

  • Gender

  • Department

  • Employment type

  • Supervisor

  • Sub company

  • Office

If there are more fields that you would like to sync in order to filter for them in Honestly Engage, let us know.

Step 3: Send your API credentials txt file to Honestly

We are nearly done here. The only thing missing is for you to send the txt file with the API credentials from Step 1 to Honestly and let us connect the connections for you.

As we are in beta phase, we review the settings closely and make sure that the integration works fine for you.

 

Share the file with password protection from an email account of an Honestly Engage Manager Account to:
Fabian Seibt
fabian.seibt@honestly.com

and send the password for the file in a second channel. E.g. via Live-Chat on Honestly.com.

 

How it works

After the initial setup, your employee list from Personio is synced with your Honestly Account.
For the first sync, we match employee data via email-address. From then on, we use Personio’s ID, to also make email changes possible.

Employees who are set up in Personio, but didn't start yet, will not be added to the Honestly Account (Hire Date must be whitelisted for this)

If employees are not sent by the Personio API anymore (e.g. when they leave the company temporarily or permanently), their account in Honestly is also deleted (Termination Date and Status must be whitelisted for this). Feedbacks stay stored.

Employees manually added via the Honestly Account Management Page, whose Email was never sent via the API, will be excluded from the automatic update process. 

The sync runs every 12 hours and updates all employees and group information that you provide via API.

 

The information given in Personio is leading in the case of data conflict.

E.g. when a department is called “Information Technology” in Honestly, and “IT” in Personio, it will be called “IT” in both systems after the initial sync.

This is treated in Honestly Engage as if people changed departments then.

Reach out to us, if you have such conflicts and want to keep the Personio data, but also consistency in Honestly Engage and we can change the department names manually for you so it stays consistent.