--- title: "Connect Pigment with Personio" slug: "connect-personio" description: "Learn to connect Personio with Pigment for seamless custom report integration. Follow our step-by-step guide to set up and import data effortlessly." tags: ["Custom Reports", "Importing Exporting Data", "Personio Integration", "Pigment Connector"] updated: 2026-01-09T13:26:34Z published: 2026-01-09T13:26:34Z --- > ## Documentation Index > Fetch the complete documentation index at: https://kb.pigment.com/llms.txt > Use this file to discover all available pages before exploring further. # Connect Pigment with Personio ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/image(22).png) This article explains how to connect Personio with Pigment to retrieve custom report results into a Pigment Block. As with all other native Pigment integrations, you’ll first need to configure a Connection in the Integration library page. Once configured, this connection can be used by any Application that is authorized as a data source. These authorized Apps are defined during the ‘Import Data’ configuration step. Now, let’s see how to configure and use this native integration! > [!WARNING] > **⚠️****Important** > > You need to be a [Pigment Workspace Admin](https://community.gopigment.com/getting-started-86/how-to-add-users-and-modify-account-types-in-pigment-286) to be allowed to configure the connector. ## Collecting the Personio API secrets to set up the connection To communicate with your Personio account, Pigment needs some credentials, which need to be generated on Personio side. (cf.[Personio Doc](https://developer.personio.de/docs/getting-started-with-the-personio-api#2-api-access-and-authorization)) Step 1. From within Personio, go in **Settings**> **Integrations**> **API Credentials.**Next click on the **Generate new credential**. ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/dc2e8a20-53ec-4fb2-934a-e8621f04255f.png) | Step 2. Fill the following fields: - Name: Pigment - Integration: Other - Personal data - Employee: Read - Custom Reports: Read - Readable employee attributes: Select fields you plan to export in the reports. Step 3. Click on **Generate new credential**. Step 4. Copy the **Client ID** and **Secret**generated. Those will be needed in the next step. | ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/93f927a1-af44-404a-8efb-1251ffb8ed62.png) | | --- | --- | > ℹ️ **Note** > > Copy the **Client ID** and **Secret**generated. Those will be needed in the next step. ## Setting up the Personio Connector Within Pigment, navigate to the Integration page from your Workspace homepage, and click on “+ Add” on the Personio integration. > [!WARNING] > **⚠️****Important** > > You need to be a [Pigment Workspace Admin](https://community.gopigment.com/getting-started-86/how-to-add-users-and-modify-account-types-in-pigment-286) to be allowed to configure the connector. ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/cf1c483d-c433-4891-938e-1c7fa0d9ad01.png) | Click on **Setup a Connection** and then fill in the following fields: - **Name**: give a name to your connection - **Application Access**: List the application which will be allowed to use this connection - **Client ID**: paste the Client ID you generated during the previous step. - **Client secret**: paste the secret you generated during the previous step. Click on **Setup**to finish the setup! | ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/50a7fa06-6dec-4fec-b91a-a2614e858789.png) | | --- | --- | ## Loading data into Pigment Once the Personio Connection is configured, open an Application that the connection is available on and open the “Import Data” interface for the object you want to import data into. For example, if you were importing data into a Transactions, you would open up list and then select **Import and Download**and then**Import**. Instead of “Upload file”, select the Integration option. From here, select the Personio Connection you just configured. > ℹ️ **Note** > > If you do not see the connection, navigate back to Integrations page, and verify that Application is on the Application Access list. ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/9343544e-c6ff-40a8-b438-3c75d93aacac.png) The Personio connector allows you to load any “**Point in Time**”**custom report** data into Pigment. > [!WARNING] > **⚠️****Important** > > “Timeframe” and “Historical data” reports are not supported yet. To do so, you need to fill-in the **Report ID** you want to load. To find this report Id, just open the board in Personio and copy the last part of the URL. For example, if the board url is `https://mycompagny.personio.de/custom-reports/6f976df8-af49-45c4-b10c-3336a5bd87b4` the Report id is `6f976df8-af49-45c4-b10c-3336a5bd87b4` . Select your prefered Language and click on **Set up import**. The data should load in Pigment within a few seconds.