# Integrate Personio with Multiplier

Integrating Personio with Multiplier helps with easy data synchronization, eliminating manual data entry and ensuring accurate employee records. This integration allows HR teams to efficiently manage employee details, payroll processing, payslips, and leave tracking across both platforms.

## Prerequisites to integrate Personio with Multiplier

To integrate Personio with Multiplier, you require:

<details>

<summary>Personio client ID and client secret </summary>

The client ID is generated from your Personio account. To generate a client ID and client secret:

1. Log in to your Personio account using your credentials.
2. From the left sidebar, select Settings from the lower left.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcuf1m-nwyEMSAdzcZ8j-ewUhnkIbiNrsSkVnNYGrv_uQlrzvV5eaYoYtAbtZSytfykYlziTTVS0d06TwIaZKS4XRaxSVEl3JzSs7arD8F8K3nJ9g3WH-1gK33Jc9S0ROdjYK9JBw?key=bzjmLB6xUDSOPLElnbZ95NBk" alt=""><figcaption></figcaption></figure>

3. Under Integrations, select **API credentials**.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc4DAFIJ7MEEpZpH2Y4NFfpIi9lllOR2MXBYPqDut13xN5LxyeLUS3zdprUPwo5dBFdzzZMtRqNPIk3crnwl8qEv2-4Beq8r2Qatk3cWzOm52-DkGVFQJ7bgPgMT66ARGVVWBOv3A?key=bzjmLB6xUDSOPLElnbZ95NBk" alt=""><figcaption></figcaption></figure>

4. Select Create custom integration.

![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfS_FiqXwSPTy5S3G9y72-4ZMVifHQMgjO4esKVVdUA6s77vpj46teAgLOqRZKVKmWX7EYaw9D3slgkBoFTuRnIdBjBAoea3exe2wrjNSNtrI_XDpJEPCIsvyS9o5gCjo8xO_NSyg?key=bzjmLB6xUDSOPLElnbZ95NBk)

5. In the text box under **Name**, enter a Custom integration name.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeKoGE3PSYOQV-awKxNua34WqamyyaaA58DpcR_2R57DAaK42eUX1dYxG4uOr6tPhZDagm81QreJsA5vteJoW1pypLK8ktpx5UQf8QXHFyLZXwQGcp1JV6eaKGcUjiUHe1xiBSk?key=bzjmLB6xUDSOPLElnbZ95NBk" alt=""><figcaption></figcaption></figure>

6. Configure access rights. Select the attributes for which you want to grant access rights. Multiplier can fetch data from Personio for the selected attributes. You can select from the two permissions:

* Read - Can only read the information
* Write - Can edit the information

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXezdISCHvrwpxKGARG0rqrUR3TW9NP245U-TuDCiTlAyZAQ6Ry_YInFpQQJl8Eu_oBpiqEePALLXVoUk6ad_pzZXGsDZgYr9xPQ3L5teyqZkPTOCwTVRv2Mt4IfLV9PPwxXQlFm2Q?key=bzjmLB6xUDSOPLElnbZ95NBk" alt=""><figcaption></figcaption></figure>

7. Once done, select Create integration.
8. You get your client ID and client secret. Copy the client ID and client secret and save it. You won’t be able to retrieve it again. Then select Finish.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdx_co6H_2xBMUPgACSiAbOkVVwH_b9AuYnylp1ipQBZVfk7_pyFxgpSnRRt9aI6x3xfzWGz5pB96v-VtOYe4TcxrEM3jRr-mysSwDpAo1mxSYrIajIVTK7Ew3r4Gd0MXS4i9qNaw?key=bzjmLB6xUDSOPLElnbZ95NBk" alt=""><figcaption></figcaption></figure>

9. Select Yes, proceed.&#x20;

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfE6MVKWlut_-BL4AC1dqwX0TabptOS7tJ-CskXZTQsWaotejF0wcY1I09CZkhox9UjD1qy72pEStkysilsc1UsTXyd_iSWp9je8qcL4Th8LejT-wKh_mX6A3IZjyHj1rRCTsLD?key=bzjmLB6xUDSOPLElnbZ95NBk" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Personio Application Identifier</summary>

Your Personio Application identifier depends on your Personio client URL.&#x20;

For example:&#x20;

* If the personio URL is <https://test-mult.app.personio.com/>

In this case, app identifier is: TEST\_-\_MULT

* If the personio URL is <https://test.app.personio.com/>

In this case, app identifier is: TEST

</details>

## Connect Personio with Multiplier

1. Log in to[ Multiplier](https://app.usemultiplier.com/login) using your credentials.
2. From the left sidebar, select Settings > Integrations.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe42BFr50Rs3Szz-E5rwM7AuDl5I-YYGaKOynpaYX7XdI39B6hr2rRR9dg7U2oYkNvgAZgnaFRecslicA_aIzJ5IlzFk7gJa8QsVHJPB6QObAWvNJrsEn9JdCPb-Y0_nmb8qNfHUg?key=bzjmLB6xUDSOPLElnbZ95NBk" alt=""><figcaption></figcaption></figure>

3. In the Integrations window, scroll down and select Personio.<br>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcDd959ZRZy7PT0EPKa3yjoOhaRGvFWO8IZwXQYf5dUzpkmbORw_DBLlbF5CSSx4Xx9kqXsywQZHTcnthc6fgKhco8_cJvB9HbE0bxkyFpfRPoHD-bLgJLTghfa7CvcJQ0Oa3_xhg?key=bzjmLB6xUDSOPLElnbZ95NBk" alt=""><figcaption></figcaption></figure>

4. Select **Connect**.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeSghT972W6yEOteGYTKox7p2FSzivUSBaMc6iDvXGFoBCwXHJ466_YFI464I4os5VObIbqc20FRFZ89w0zYxry-jHNSuWo_jlDJrNsU5ulp6ouli1LFU9BW6GbdPLSpq3wLXlTag?key=bzjmLB6xUDSOPLElnbZ95NBk" alt=""><figcaption></figcaption></figure>

5. In the dialog box that opens, enter your Personio Client ID, Personio Client Secret.

To retrieve Personio client ID and Personio Client Secret, follow the steps in [Prerequites to integrate Personio with Multiplier](https://docs.google.com/document/d/1J7dzvKwBT8MjKmGUTtKzP49BvGJ90U6xR95e2zIaQOY/edit?tab=t.0#heading=h.4gi6qg5d9bja).&#x20;

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXevGZuhjiF7_gV1cypI7-0TMP44rnxuI_gam2A47NAk2mSPO1gYvGx2liSL4OG8K6GWrcOp6dLEfHU5panl_v5GT7PYxb_96Dy3HKKycyBTqBVGgWFyK5AGHpdl4CJiA09v8QguFA?key=bzjmLB6xUDSOPLElnbZ95NBk" alt=""><figcaption></figcaption></figure>

6. Enter your Personio Application Identifier as per your personio URL. To find your identifier, refer to Personio Application identifier.&#x20;

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf6RN9FlJuItE7oZfKcbVAbTYFhfLg8TwjBcVAajmoc1jeCEN_JrUCWW8pUQRRf3xRS2OUzyIFpdph5owdkzUq2atxBi0wzPvcGwDKHQpGDsyodCOl6ChPbQ1uG0q6LVe0LcSPbtg?key=bzjmLB6xUDSOPLElnbZ95NBk" alt=""><figcaption></figcaption></figure>

7. Select **Submit**. Once done, Personio is integrated and the status shows connected.&#x20;

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd5sW0SxIeS2u4jds2YbliSFvo3TaMVYGhYUjug6n34CVo09dMi8pFDQ6VwvpKHChFQoS-4dNIDw7nrrJgyTg9rm6XPINGdTZyfbHb2cZkaKfLygGJMZvHVm9njefKon3EpXJ6Q?key=bzjmLB6xUDSOPLElnbZ95NBk" alt=""><figcaption></figcaption></figure>

## Enable EOR Data Sync

Prerequisite: Ensure employees are activated on the Multiplier platform. If the employees are not activated, their profiles will not sync.

1. Once you have integrated Personio with Multiplier, from the left sidebar go to Settings > Integrations
2. Select the Connected tab.
3. Select Personio.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf7pqhsjeBPGQ7EJsT6m6Ibf7Ap4D_SgCbfDp7igvN006AWl3hZF5zzgs9w7UEv0C9j7NXa1vZm-a4H4Ok-SrKBkbSEZsAr8sxEF7vTuoYWrHiPPkAr7U9dEslBenRQSw?key=bzjmLB6xUDSOPLElnbZ95NBk" alt=""><figcaption></figcaption></figure>

4. Enable the toggle next to EOR Employees’ data sync.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdMa6KfOHWTSIyl57KsGw7SdoZ2xd5WlszJoU5W0hhrQUhs3fgQT0-OkdaUN-ISou1RhjnihRGpu6ePwe2bmT2nr_cLKDazye8CJFOL0Qs0GROtEGtMmWyiA2IDlvNenYb6Uux_?key=bzjmLB6xUDSOPLElnbZ95NBk" alt=""><figcaption></figcaption></figure>

5. In the dialog box that appears, select Continue.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd7a3Hsp2ycJflXiUhgz1yhQqyBdl1nkC975rQMDdXWzD6OkxwHhgjWhykusP_dfvTWyqfXKxX-IYDrXrqgWk5rbAO9ydZYAMFRhhyQiR4GOX_JKt_nBtzgBhIm6ZNxJPGodBTbeA?key=bzjmLB6xUDSOPLElnbZ95NBk" alt=""><figcaption></figcaption></figure>

EOR employee’s data is synced.&#x20;

## Enable Global Payroll (GP) Data Sync

1. Once you have integrated Personio with Multiplier, from the left sidebar go to Settings > Integrations
2. Select the Connected tab.
3. Select Personio.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf7pqhsjeBPGQ7EJsT6m6Ibf7Ap4D_SgCbfDp7igvN006AWl3hZF5zzgs9w7UEv0C9j7NXa1vZm-a4H4Ok-SrKBkbSEZsAr8sxEF7vTuoYWrHiPPkAr7U9dEslBenRQSw?key=bzjmLB6xUDSOPLElnbZ95NBk" alt=""><figcaption></figcaption></figure>

4. Enable the toggle next to Global payroll employees’ data sync.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdMa6KfOHWTSIyl57KsGw7SdoZ2xd5WlszJoU5W0hhrQUhs3fgQT0-OkdaUN-ISou1RhjnihRGpu6ePwe2bmT2nr_cLKDazye8CJFOL0Qs0GROtEGtMmWyiA2IDlvNenYb6Uux_?key=bzjmLB6xUDSOPLElnbZ95NBk" alt=""><figcaption></figcaption></figure>

The data is fetched from personio to Multiplier. This can take several minutes and depends on the number of employees

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeEOCXsrWS6qAVZtfYKqRY41euYW9XsHLlDl_uwO4ygLAeQyiPmdfdaAZfy1el-vbCLRyrktHCb9lnhQlCmVh1lBlK9UylIeikSYg96Uzic5LM6XvlPXafYlgc0Rq5JWq4em1Gw?key=bzjmLB6xUDSOPLElnbZ95NBk" alt=""><figcaption></figcaption></figure>

### Fact sheet for Global payroll Integration with Personio

#### &#x20;Sync parameters for Global payroll sync

* Frequency of sync - Once in 6 hours
* Type of sync - API
* Sync Trigger: Automatic
* Direction of Data flow - Personio to Multiplier

### Field names that will be integrated: <a href="#h_518d3b83e8" id="h_518d3b83e8"></a>

| Field Category     | Field Name on Multiplier | Field name on Personio           |
| ------------------ | ------------------------ | -------------------------------- |
| Basic details      | First name               | first\_name                      |
| Basic details      | Last name                | last\_name                       |
| Basic details      | Gender                   | gender                           |
| Basic details      | Date of birth            | date\_of\_birth                  |
| Compensation       | Currency                 | fix\_salary.currency             |
| Compensation       | Base Salary              | fix\_salary.value                |
| Compensation       | Frequency                | fix\_salary\_interval            |
| Contact details    | Personal Email id        | emailNav.emailAddress            |
| Contact details    | Work Email id            | email                            |
| Employment details | Employee ID              | id                               |
| Employment details | Country                  | No field (requires custom field) |
| Employment details | Employment status        | status                           |
| Employment details | Job title / Designation  | position                         |
| Employment details | Start date, end date     | hire\_date, termination\_date    |
| Employment details | Employment type          | employment\_type                 |
