> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Personio

> 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.

This guidance assumes you have Admin privileges for your Personio account.

## Generating your API credentials

<Steps>
  <Step title="Sign in to Personio">
    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 Tab" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/personio/settings-tab.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=b8761296e1aa0b70c6e08a351059657e" width="1268" height="1634" data-path="images/personio/settings-tab.png" />
    </Frame>
  </Step>

  <Step title="Navigate to API credentials">
    In the Settings menu, scroll down to the "Integrations" section and click on "API credentials".

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="API Credentials Section" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/personio/api-credentials-section.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=438af033cf14756957c2200e19c82fed" width="2940" height="1640" data-path="images/personio/api-credentials-section.png" />
    </Frame>
  </Step>

  <Step title="Create custom integration">
    On the "Connected integrations" page, click the "Create custom integration" button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Create Custom Integration" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/personio/create-custom-integration.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=14662ac99e4926d4a66a3bc0123490e7" width="2392" height="386" data-path="images/personio/create-custom-integration.png" />
    </Frame>
  </Step>

  <Step title="Enter integration details">
    In the first step of the integration creation dialog, enter a name for your integration, and then click on the Next button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Integration Details Step" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/personio/integration-details-step.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=976ef38a2e090b88312867ed3bd5e33e" width="1870" height="1708" data-path="images/personio/integration-details-step.png" />
    </Frame>
  </Step>

  <Step title="Select permissions">
    In the second step, select the data types you want to grant access to. You must select at least one permission to continue. Common options include:

    * **employees** (Read/Write)
    * **attendances** (Read/Write)
    * **Time off** (Read/Write)
    * **documents** (Read/Write)
    * **Recruiting** (Read/Write)
    * **Webhooks** (Read/Write)

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Configure Access Rights" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/personio/configure-access-rights.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=29a8474f1e51168b18258e995745b0b3" width="1844" height="1712" data-path="images/personio/configure-access-rights.png" />
    </Frame>
  </Step>

  <Step title="Choose employee attributes (Optional)">
    If you selected "employees" permissions, you can optionally click "Choose attributes" to select specific employee attributes you want to include in your data. You can also select all attributes.
  </Step>

  <Step title="Create integration">
    After selecting your permissions, click "Create integration" to generate your API credentials.
  </Step>

  <Step title="Copy API credentials">
    Once the integration is created, you'll see your API credentials displayed:

    * **Client ID**: A unique identifier for your integration
    * **API Secret**: A secret key for authentication

    Copy both values to a secure location. You can use the "Copy" buttons provided.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="API Credentials Generated" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/personio/api-credentials-generated.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=f33d7229f89f79fac5603f2416b93148" width="1866" height="1712" data-path="images/personio/api-credentials-generated.png" />
    </Frame>
  </Step>

  <Step title="Copy API credentials">
    Copy your API credentials – client id and client secret to a safe place, then click "Finish".
  </Step>
</Steps>

## Connecting with StackOne Hub

<Steps>
  <Step title="Paste 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="API Credentials" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/personio/image7.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=485976bd46a3bcb13662a1ff78e8fe78" width="948" height="1472" data-path="images/personio/image7.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!

## Useful Links

<Card title="API Reference" icon="link" href="https://developer.personio.de/docs/getting-started-with-the-personio-api">
  [https://developer.personio.de/docs/getting-started-with-the-personio-api](https://developer.personio.de/docs/getting-started-with-the-personio-api)
</Card>