Personio

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

Install the Personio integration

Install Personio from Available integrations 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.

Connect a Personio account

1. Click Connect Account.

2. Enter a Tenant ID. This can be any ID you choose. Click Get connection link.

3. Open the generated link. You can also share it with your customer so they connect their own Personio account.

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.