Setting Up Personio Plugins – Deel

This article explains how to set up Personio plugins as part of HRIS integration on Deel.

Before you begin

To successfully complete this setup, you’ll need:

A user with an admin role in Deel
A user with an admin role in Personio

To learn about Personio plugins for Employees of Record (EOR) instead, check out our article on How To Set Up The Personio Plugin for EOR Employees.

Step 1. Connect the integration

In this section, we’ll guide you through how to connect Deel to Personio.

To connect to Personio:

1. In Deel, go to More > Apps and search for Personio.
2. On the Personio integration page, click Connect Personio.

The integration is now connected, and you can start to configure the integration.

Step 2. Configure the integration

In this section, we’ll guide you through configuring the integration so that data can sync successfully.

After connecting Personio, you need to configure:

Worker data sync
Field mapping
People match

Worker data sync

To configure the worker data sync:

1. Configure recommended fields in Personio

a. Go to Settings and locate API credentials within the Integrations card

b. Select Deel from the list of connected integrations.

c. On the Deel integration details page, locate the access rights tab and choose attributes.

d. Search for the recommended fields and turn them on.

e. Click on the update button to confirm changes.

The count of chosen attributes will increase, and back in your Deel setup, all selected fields will now be available.

To fully use this plugin, enable the following fields in the Deel app on Personio:

Personal email (required)
Supervisor (highly recommended)
Office (highly recommended)
Department (highly recommended)
Gender
Cost center
Created at
Last modified
Employment type
Work schedule
Weekly hours
Fixed salary
Hire date
Team
Termination date

2. Configure syncing employees plugin.

By default, this plugin will be disabled. Reach out to your Deel onboarding manager to activate it before proceeding with the configuration.

1. After activating, click the Enable button to begin setting up.

A select option will appear, prompting to choose the "personal email" field.

This is a mandatory field

If the "personal email" field does not already exist in Personio, create it before proceeding.

Field mapping

The field mapping plugin enhances HR capabilities by syncing HRIS data with Deel. It can also be used to tailor how HRIS data syncs with Deel.

This plugin works together with the Worker data sync plugin. However, it is not related to the Global Payroll field mapping feature.

To map Deel fields with their corresponding Personio values, use the Edit field mapping button.

For custom fields mapped in Personio, this plugin can help control how the information flows into Deel.

People Match plugin

This plugin shows which members of a team managed in Deel are linked to corresponding Personio profiles.

Finding matching profiles in Personio is the first step to configuring the integration because Deel syncs data only for matched profiles.

Troubleshooting

Worker data sync errors

Sync errors will be visible in bulk on the Worker data sync plugin overview page, and can also be viewed under individual employees.

To view and resolve Worker data sync errors:

Step 1. Select an employee's Contract Overview page

Step 2. Click View Errors to reveal all errors for review and resolution

Frequently Asked Questions

[ACCORDION] How can Personio and Deel user profiles be matched?

Matching Deel and Personio users is a critical step for Deel integration because we sync data only for profiles that are matched.

Our integration matches profiles via a check of the user's email address. If the email provided in Deel finds a Personio profile with a corresponding email, then we link those two users.

If any users in Deel cannot be located in Personio, this is usually because their matching profile can't be found in Personio.

To resolve this issue, please ensure that all users in Deel have a corresponding user profile in Personio, and that the profile in Personio uses the same email address stored in Deel.

[ACCORDION] How often will the integration sync?

It will automatically sync data every couple of hours.

[ACCORDION] Does the integration sync balances?

No, the integration does not sync or reconcile balances.

[ACCORDION] Why are there discrepancies in balances between the two systems?

Discrepancies can arise if the total allowance in a HRIS system differs from that in Deel. To resolve this, ensure that HRIS policy is aligned with Deel's. If alignment isn't possible, contact assigned Customer Success Manager (CSM) to discuss adjusting Deel’s contracts to better fit the company's policy where feasible.

[ACCORDION] Why are the total allowances not the same in both systems?

The HRIS system may have PTO policies that differ from those in Deel, potentially leading to variations in accrual logic. As Deel cannot automatically align external systems to our policies, any necessary adjustments must be made manually to ensure consistency.

[ACCORDION] Will there be notifications of integration issues?

Yes, Deel will send out notifications of integration sync issues. Specify an organization manager (or as many emails as needed) email to receive these notifications.

To do this:

✅ Step 1 - Go into the Personio integration and click on the inverted ellipsis (three dots) next to the Sync Integration button.

✅Step 2 - Select Email notifications settings from the list of options.

✅Step 3 - In the Email notifications settings drawer, click on the Add button to add an email notifications list.

[/ACCORDION]

In this article