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

# Personio

> Connect Personio to Doozy via Merge.

## Overview

To authenticate Personio, you will need to provide the following information:

* **Client ID**
* **Client Secret**

## Prerequisites

* You have Administrator permissions in your company's Personio instance

***

## Step 1: Generate Your API Credentials

<Steps>
  <Step title="Log into your Personio account and visit 'Settings' in the bottom left." />

  <Step title="On the 'Integrations' tile, select 'API credentials'." />

  <Step title="Click 'Create custom integration'." />

  <Step title="Enter a name for your new integration (e.g., 'Doozy Integration') and click 'Next'." />

  <Step title="Under 'Select the attributes you want to grant access rights for', select:">
    * Employees
    * Absences *(for Time Off Announcements)*
  </Step>

  <Step title="Under 'Readable employee attributes', select the fields you want to sync:">
    **Required for Doozy:**

    * Email
    * First name
    * Last name
    * Hire date
    * Termination date
    * Status
    * Supervisor
    * Office
  </Step>

  <Step title="Click 'Create integration'." />

  <Step title="Your API Credentials will appear. Copy and save both the Client ID and Client Secret.">
    <Warning>The Client Secret is only shown once. Make sure to save it securely.</Warning>
  </Step>
</Steps>

## Enter Credentials into Doozy

<Note>You must be a **Doozy admin** to connect an HRIS integration.</Note>

<Steps>
  <Step title="Go to the Doozy web app.">Navigate to [Workspace Settings](https://doozy.live/app/settings/workspace) → **Integrations** → **HRIS**.</Step>

  <Step title="Choose Personio as the HRIS you want to connect." />

  <Step title="Client ID: Paste your Client ID." />

  <Step title="Client Secret: Paste your Client Secret." />

  <Step title="Click Submit." />
</Steps>