# Personio

> Source: https://truto.one/docs/integration-guides/personio/

Personio connects with a client ID and client secret from a custom integration in your Personio account.

:::callout{type="info"}
- Your Personio user needs API access rights to create API credentials.
:::

## Install the Personio integration

Install Personio from [Available integrations](https://app.truto.one/integrations/available/ecbc79da-50a0-47ff-8be0-228edf1d8d16) in each environment you connect accounts from.

## Create API credentials

1. In Personio, go to **Marketplace** → **Connected integrations**.
2. Click **Create custom integration** to generate a `client_id` and `client_secret`.
3. To read employees, give the credentials access to the employees endpoint and select the attributes Truto may read under **Readable employee attributes**. Attributes you leave out are not returned.

See Personio's [Getting started with the Personio API](https://developer.personio.de/docs/getting-started-with-the-personio-api).

## Connect a Personio account

1. Click **Connect Account**.
   ![Click Connect Account](https://docs-assets.truto.one/truto-connect-account.png)
2. Enter a Tenant ID. This can be any ID you choose. Click **Get connection link**.
   ![Get connection link](https://docs-assets.truto.one/truto-connect-account-modal.png)
3. Open the generated link. You can also share it with your customer so they connect their own Personio account.
   ![Share connection link](https://docs-assets.truto.one/truto-connect-account-link.png)
4. Select **Personio**.
5. Fill in the form and click **Connect**:

   | Field | Required | What to enter |
   |---|---|---|
   | **Client ID** | Yes | The custom integration's `client_id`. |
   | **Client Secret** | Yes | The custom integration's `client_secret`. |
6. Close the tab when you see the connection successful message. The new account appears under **Integrated Accounts**. Click its Account ID to see its details and make API calls.