Buuky Help
This page is also available in: Deutsch

Personio Integration

Tags:

Buuky offers an integration with Personio as employee management system. The integration allows both employees and absences to be synchronized. This means that employees do not have to be maintained twice and bookings are automatically released in case of an absence (e.g., sickness).

What information is synchronized?

Employees

Employee synchronization ensures that...

  • new employees with the status active and leave are automatically created in Buuky and an invitation email is sent
  • the Buuky account is also updated when names or emails are changed
  • the associated Buuky account is deleted when employees leave (inactive status).

Absences

The absences from Personio are used to cancel bookings in the absence period. This includes absences such as illness, vacation, and parental leave, but also self-configured absences.

Exception: Bookings with a blocker are not automatically deleted as they are not necessarily affected by the absence. For example, if places are blocked for new employees.

Synchronization time

Buuky automatically queries the Personio interface every 10 minutes. If required, synchronization can also be triggered manually via Buuky administration.

Configuration

Personio API access data is required so that Buuky can query the necessary data from Personio. These can be created in the Personio settings and then stored in the Buuky administration. The following steps are necessary for this.

1. Create Personio API Credentials

This step must be carried out in Personio.

To create the access data, go to the settings in Personio (1). Under the menu item API credentials (2), click on the button generate new credential (3). We recommend using Buuky as the name (4) and for the Personal data (5), you must check Read for both employees and absences. Write rights are not required.

The following values must be selected in the Readable employee attributes (6) section that then appears:

  • Email
  • Last day of work
  • Last name
  • Status
  • First name

Then confirm everything with Generate new credential. The values now displayed for Client-ID (7) and Secret (8) must be copied and stored in Buuky in the next step.

Settings

New API access data

Configure access

2. Enter the Personio API Credential in Buuky

This step must be carried out in Buuky.

The Personio integration can be configured in Buuky under the Integration item and the Personio sub-item. On the configuration page, the Personio Client-ID and the Personio Secret must be entered in the corresponding fields and saved. If the API access data is saved, an initial test connection is carried out to validate the connection data.

From now on, synchronization is performed automatically and does not need to be triggered manually.

Synchronization control in Buuky

In addition to the setup, the Buuky configuration offers further options for Personio integration.

Synchronize now

The first synchronization run can be carried out directly from Personio by clicking Synchronize now. Depending on the number of employees and absences already entered, the first call may take some time.

Test mode

The test mode allows for an initial test before the Personio integration is actively used. If the test mode is active, no changes are saved in Buuky and no email invitations are sent. In addition, no time-controlled synchronization takes place.

Delete Integration

The configured integration can be deleted here. The Buuky users are retained and must be deleted separately.


This page is also available in: Deutsch