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

# Humaans

> Connect Humaans to Doozy via Merge.

## Overview

To authenticate Humaans.io, you will need to generate an API Key and paste it into the linking flow.

## Prerequisites

* You have Admin permissions in your company's Humaans.io instance

***

## Step 1: Generate Your API Key

<Steps>
  <Step title="Log into your Humaans.io account." />

  <Step title="From the sidebar, click the three dots to extend the drop-down menu. Click 'API access tokens'." />

  <Step title="Create or edit an existing API Key.">
    * If you have an existing API key, click the edit button to update the scopes
    * If you do not have an existing key, click 'Generate new token'
  </Step>

  <Step title="Configure the scopes you will need for Doozy." />
</Steps>

### Required Scopes

| Scope                            | What It Enables                                                                                                                  |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **View public data**             | Basic employee data: name, email, job title                                                                                      |
| **View public and private data** | Required for Doozy to detect pre-hires and terminated employees. Also enables: date of birth, country, city, state, phone number |

<Note>Without "View public and private data", employees will not be picked up until their hire date, and terminated employees will not be identified as such.</Note>

<Steps>
  <Step title="Copy the generated API key.">
    <Warning>The API key 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 Humaans as the HRIS you want to connect." />

  <Step title="API Key: Paste your Humaans API key." />

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