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

# Lucca

> Connect Lucca to Doozy via Merge.

## Overview

To connect Lucca, you will need to provide the following information:

* **Tenant URL**
* **API Key**

## Prerequisites

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

***

## Step 1: Locate Your Lucca Tenant URL

<Steps>
  <Step title="Log in to your Lucca tenant." />

  <Step title="Copy the base URL from your browser's address bar.">For example: `https://yourcompany.lucca.io`</Step>
</Steps>

## Step 2: Create an API Key

<Steps>
  <Step title="In Lucca, click the Settings gear icon in the top right." />

  <Step title="Select 'API Keys'." />

  <Step title="Click 'Generate a new API Key'." />

  <Step title="Name your API Key (e.g., 'Doozy Integration')." />

  <Step title="Add the following permissions:">
    * **Consult / create / modify users** (Required)
    * **Consult leaves** (Optional - for Time Off Announcements)
    * **Make absence requests** (Optional - for Time Off Announcements)
  </Step>

  <Step title="Enter your email address as the Technical contact." />

  <Step title="Select 'Third-party publisher' as the API key usage." />

  <Step title="Click 'Generate a new API key'." />
</Steps>

## Step 3: Configure Role Permissions

<Steps>
  <Step title="On the API Keys page, click 'Role administration' for your new key." />

  <Step title="Go to the 'Co-workers' tab and add the following permissions:">
    * **See future employees**
    * **See former employees**
    * **View employee jobs** (Optional)
    * **View employee managers** (Optional)
    * **View employee qualifications** (Optional)
  </Step>

  <Step title="Save your role configuration." />
</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 Lucca as the HRIS you want to connect." />

  <Step title="Tenant URL: Enter the base URL from Step 1." />

  <Step title="API Key: Enter the API key from Step 2." />

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