> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Personio - How do I link my account?

# Overview

To authenticate with Personio, you need a few pieces of information:

1. **Client ID** - Your unique account identifier.
2. **Client Secret** - Your unique account secret associated with the Client ID.

This guide will walk you through finding or creating those credentials within Personio.

### Prerequisites:

* You must set up an account with Personio.

#### Step 1: Finding Personio Client ID

1. Log into your Personio account with admin access and navigate to `Settings` > `API credentials` page in settings.
2. Click `Create custom integration`.
3. In the `Name` field, enter the name of the new integration. Click `Next`.
4. Select the needed scopes and attributes, then click `Create integration`.
5. Copy your `Client ID`.

#### Step 2: Finding Personio Client Secret

1. From the previous step, copy the `Client secret` values and store them in a safe place. Click `Finish`.

Important: Copy and store your API secret securely, it will not be visible again once you leave the creation dialog.

#### Step 3: Connect Your Personio Account

<img src="https://mintcdn.com/nango/fQZq_4crLIXjDtDP/integrations/all/personio/nango_connect_ui.png?fit=max&auto=format&n=fQZq_4crLIXjDtDP&q=85&s=fa5040087a3cb817f04767b6e4ed3b53" width="447" height="755" data-path="integrations/all/personio/nango_connect_ui.png" />

To authenticate using your API credentials, navigate to the Personio authentication form.
Enter your credentials as follows:

* Partner ID: User-created identifier in Personio (must follow: *UPPER\_SNAKE\_CASE* case).
* App ID: User-created unique identifier for the application (must follow: *UPPER\_SNAKE\_CASE* case).
* Client ID: Personio generated Client ID.
* Client Secret: Personio generated Client Secret.

Click "Connect" to complete the authentication.