Global Payroll Employee Sync for Personio

Personio’s intelligent HR platform helps small and medium-sized organizations unlock the power of their people by simplifying complex, time-consuming tasks.

This integration enhances HR team productivity by seamlessly connecting employee data and automating repetitive tasks. By reducing manual data entry, it minimizes the risk of errors in HR processes and communications, ensuring a smoother onboarding experience and preventing unnecessary delays.

The integration is free for customers using both Personio and Remote.

In this article

• Is this integration right for me?
• How to enable Personio integration
  • Create Sync to Remote custom field
  • Create your API credentials
  • Connect Personio with Remote
  • Set up employee sync
  • Enable salary and job title syncs for EOR
• How to disable the integration
• Troubleshooting/FAQs

Is this integration right for me?

Before enabling the integration, it is important to understand who it is available for and how data synchronization works to ensure it meets your needs. Listed below and key details to help you decide if this integration is the right fit for you:

Data synced:

• Employee data (for Global Payroll employees)
  • For new hires: The following information is synced upon hiring:
    • Email address (used as a unique identifier for each user)
    • Full name
    • First name, Middle name, Last name
    • Preferred name
    • Preferred pronouns
    • Start date
    • Job title
    • Country
    • Address (excluding country)
    • Department
    • Supervisor
    • Emergency contact
    • SSN (for US employees)
    • Birth date
    • Legal sex
    • Mobile phone
    • Nationality
  • For active GP employees, we sync and update:
    • Full name
    • Job title
    • Salary (If salary is entered in Personio)
    • Department
    • Supervisor
    • Emergency contact
    • SSN (for US employees)
    • Address (excluding country)
    • Start date
    • Birth date
    • First name, Middle name, Last name
    • Preferred name
    • Preferred pronouns
    • Legal sex
    • Mobile phone
    • Nationality
• Time off for Global Payroll employees: Approved future time off requests can be synced from Personio into Remote using Employee Time off Sync with Personio integration.

Direction of sync: One-way from Personio to Remote

Frequency of sync: Once per hour

How to enable Personio integration

Prerequisites

Before enabling the integration, you need to have administrative permissions in Personio.

Create Sync to Remote custom field

To set up employee sync, you need to create a Custom field in Personio to specify which employments and contractors should sync through the integration.

• [important] Notice for existing integration users

  Previously, employees were identified for syncing using the Pay Group and Employment Status fields. To simplify the process, we now use a custom field called Sync to Remote as.

  • If you have already set up the integration using Pay Group and Employment Status, no changes are required—your integration will continue to function as expected.
  • In the coming months, we will migrate existing data to the new Sync to Remote as method.

Follow these steps to create a custom field in Personio:

1. Log into your Personio account.

2. Navigate to Settings > People > Employee information.

3. Click on the Add an attribute button.

4. Configure the custom field using the following settings:

   1. Field Name: Sync to Remote as (copy/paste exactly to avoid errors)

   2. Type: List of options
   3. Answers: As global payroll employee

Similar to Sync to Remote as, you can create custom fields for data that is not in Personio by default, for example: country, personal email, address line 1, address line 2, city, state, postal code, middle name, nationality, birth date, mobile phone, preferred pronouns, legal sex, SSN, emergency contact name, emergency contact relationship, emergency contact email, emergency contact phone, emergency contact mobile phone.

Excluding dates, you can use type General for most of these, or you can opt for List of options if you want a limited set of options.

Create your API credentials

1. From Settings > Integrations > API credentials, click on the Create custom integration button.

2. In the next step, make sure to select Read access for employees and click on Choose attributes > Select all and click on Create integration.

This returns a client ID and API secret that you will need for the next step.

Connect Personio with Remote

Follow these steps to connect Personio with Remote and enable the integration:

1. Log in to Remote and go to Company settings > Integrations & APIs.

2. Click Add on the Personio for GP integration card and then on Add to Remote button.

3. Submit your Personio login credentials that you received in the previous step to authenticate the integration. Your credentials will be used to securely sync your Personio account to Remote.

4. Once you’ve received the success message, you can close the pop-up window. You've authenticated us to be able to access your data through the integration.

Your Personio account is now linked to Remote.

Enable employee information sync

Now that your Personio for GP integration is set up, you can configure your accounts to sync employee information from Personio to Remote.

1. In Personio, navigate to the Employees tab and open the Employee List.

2. Select the employee you want to sync with Remote and click on Edit profile.

3. In the Sync to Remote as field, choose As global payroll employee and click Edit profile.

4. Repeat these steps for all employees you want to sync with Remote.

Your Personio account is now linked to Remote. From this moment on, every hour, Remote will perform automatic syncs of the employees you have selected earlier. To do an immediate sync at any time, you also have an option of performing a manual sync. This option comes in handy when you add a new employee to the sync list and want to quickly run a sync to add that employee to Remote’s server.

In Remote, navigate to Company settings > Integrations & APIs > Personio for GP. On the overview page, click on the Sync button in the Manually sync data from Personio to Remote section.

Note: When new employees are added, their full name, email, start date,

Enable salary and job title sync

Notes:

• Direction of sync will be from Personio to Remote.
• For GP employees, any salary and job title change requires a contract amendment.
• If salary and job title syncs are enabled, contract amendment workflows will be triggered automatically.
• Salary can only be synced if the annual salary is entered in Personio.

To enable salary and job title sync, follow these steps:

1. In Remote, go to Company settings > Integrations & APIs. Then select the Personio for GP integration card.

2. Under the Settings tab, assign a designated user to oversee contract amendments.

3. Toggle Automatically sync employees’ salary and job title to enable syncs from Personio to Remote.

To check an individual employee’s contract amendments, visit the Employee Agreement Amendments section on their profile.

To see contract amendments for all employees, go to the Requests section.

When you update salary or job titles in Personio, include a reason for the change. Ideally, the reason should align with Remote’s classification:

• Annual pay adjustment
• Country rule change
• Error correction
• Job change reevaluation
• Promotion

If no reason is provided, the system will default to “Contract change requested from Personio integration”.

How to disable the integration

If you want to disable the Personio integration,

1. Log into Remote and navigate to Company settings > Integrations & APIs > Personio for GP.

2. Click on the Remove integration button.

3. From the pop-up, select Delete integration to confirm.

Troubleshooting/FAQs

I followed the setup instructions but none of the employees are syncing to Remote

If none of the employees are syncing to Remote, it suggests an issue with the configuration of permissions. Please verify that all required permissions are included in the API credentials.

Some of the employees are not syncing to Remote

If some of the employees are not syncing, try the following:

1. Check that the employees you want to sync have the right value for the custom field Sync to Remote as → As global payroll employee.
2. Double-check their email addresses. We match records in Personio and Remote based on their work and personal emails.
   1. To sync an existing user in Remote, their email address in Personio must be an exact match. Try updating the email to match and do a manual sync on Remote. You can then change the email address back — but note that email changes in Personio will always sync to Remote.
   2. If the email address of an employee is linked to an archived profile of the same person, contact our support team to have them merge the profiles.

If you’ve confirmed there is no issue with the above but the problem still persists, please reach out to our support team at help@remote.com and send:

• Screenshots of the Permission Group configuration for the Service User, found in Settings > Integrations > API Credentials in Personio.
• Full list of employees that are not syncing. For each user, provide:
  • Name
  • Email in Remote
  • Personal and work email in Personio
  • “Sync to Remote as” field value
  • Start date
  • Employee ID from Personio (found in the URL of the employee’s profile)

I want to make changes to the employee’s profile before onboarding starts

You can update a new employee’s name, start date, job title, or email address in Personio, and these changes will sync to Remote as long as the onboarding has not started in Remote.

• Data changes may take up to an hour to sync from Personio to Remote. To sync immediately, you have to perform a manual sync.
• Employee changes will not sync from Personio to Remote during the onboarding process, as these details are used to generate the employment agreement.