> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-claude-issue-384-20260409-1436.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Personio - Custom Integrations

> Follow these steps to connect Personio with StackOne Hub successfully.

<Warning>
  Ensure you have Admin privileges for your Personio account.
</Warning>

If you've been directed to StackOne to integrate with Personio, the following steps will help you understand the process and any necessary actions to configure successful integration.

## Generating your API credentials

<Steps>
  <Step title="Sign in and open Settings">
    Sign in to the Personio website and click on the Settings tab on the left-hand side menu.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Settings" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/fIC4erPUQXS94q1m/images/personio-custom-integrations/image1.png?fit=max&auto=format&n=fIC4erPUQXS94q1m&q=85&s=09735b7fcf7dddbce1b4d4758fb51d60" width="546" height="724" data-path="images/personio-custom-integrations/image1.png" />
    </Frame>
  </Step>

  <Step title="Open API credentials">
    Click on the API credentials inside the integration box.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="API Credentials" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/fIC4erPUQXS94q1m/images/personio-custom-integrations/image2.png?fit=max&auto=format&n=fIC4erPUQXS94q1m&q=85&s=628bfcd670c644e0213cdbae882783d4" width="1529" height="503" data-path="images/personio-custom-integrations/image2.png" />
    </Frame>
  </Step>

  <Step title="Go to Marketplace">
    Click on the Go to Marketplace button. It'll direct to the Marketplace page.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Marketplace" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/fIC4erPUQXS94q1m/images/personio-custom-integrations/image3.png?fit=max&auto=format&n=fIC4erPUQXS94q1m&q=85&s=3ee12bc01fb7931c56f784b6bada6908" width="1536" height="491" data-path="images/personio-custom-integrations/image3.png" />
    </Frame>
  </Step>

  <Step title="See Connected Integrations">
    Click on the See Connected Integrations button. It'll direct to the Connected Integration page. Here, click on the Create Custom Integration button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Connected Integrations" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/fIC4erPUQXS94q1m/images/personio-custom-integrations/image4.png?fit=max&auto=format&n=fIC4erPUQXS94q1m&q=85&s=a994be86467dde66124768bccd72cd47" width="1527" height="163" data-path="images/personio-custom-integrations/image4.png" />
    </Frame>
  </Step>

  <Step title="Create Custom Integration">
    Write your company name inside the name field, and please make sure your company name is in capital letters and click on Next button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Custom Integration Name" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/fIC4erPUQXS94q1m/images/personio-custom-integrations/image5.png?fit=max&auto=format&n=fIC4erPUQXS94q1m&q=85&s=dc26f675e9879f18b8a82c5fe6c477b0" width="1388" height="920" data-path="images/personio-custom-integrations/image5.png" />
    </Frame>
  </Step>

  <Step title="Select Permissions">
    Select at least one permission to continue; for example, to get Employees data, select Employees or to get Documents data, select Documents too.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Permissions" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/fIC4erPUQXS94q1m/images/personio-custom-integrations/image6.png?fit=max&auto=format&n=fIC4erPUQXS94q1m&q=85&s=b575fbba1cea83221a21dbf35e29d7c3" width="1816" height="886" data-path="images/personio-custom-integrations/image6.png" />
    </Frame>
  </Step>

  <Step title="Choose Attributes">
    Click on Choose attributes. Select those attributes you want to show in your data, or select all attributes.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Attributes" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/fIC4erPUQXS94q1m/images/personio-custom-integrations/image7.png?fit=max&auto=format&n=fIC4erPUQXS94q1m&q=85&s=2fec296d4296fb3207ed833936b189b8" width="1145" height="723" data-path="images/personio-custom-integrations/image7.png" />
    </Frame>
  </Step>

  <Step title="Create Integration">
    Click on the Create Integration button. Make sure your credential is generated successfully, then click on the Finish button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Create Integration" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/fIC4erPUQXS94q1m/images/personio-custom-integrations/image8.png?fit=max&auto=format&n=fIC4erPUQXS94q1m&q=85&s=b8841237f61bcb5088545ca0e1a1812b" width="1153" height="915" data-path="images/personio-custom-integrations/image8.png" />
    </Frame>
  </Step>
</Steps>

NOTE: Copy your API credentials – client ID and client secret to a safe place.

## Connecting with StackOne Hub

<Steps>
  <Step title="Enter API Credentials">
    Paste the API client ID, and client secret in the StackOne Hub after selecting Personio as your HRIS provider.
  </Step>

  <Step title="Enter Company Name">
    Copy your company name from your Personio account, then paste your company name inside the Personio app id; please make sure the name is in capital letters.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Company Name" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/fIC4erPUQXS94q1m/images/personio-custom-integrations/image9.png?fit=max&auto=format&n=fIC4erPUQXS94q1m&q=85&s=0da08a1643404b5174ace41fc33bb046" width="948" height="1472" data-path="images/personio-custom-integrations/image9.png" />
    </Frame>
  </Step>
</Steps>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!