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
1
Log in to your Lucca tenant.
2
Copy the base URL from your browser's address bar.
For example:
https://yourcompany.lucca.ioStep 2: Create an API Key
1
In Lucca, click the Settings gear icon in the top right.
2
Select 'API Keys'.
3
Click 'Generate a new API Key'.
4
Name your API Key (e.g., 'Doozy Integration').
5
Add the following permissions:
- Consult / create / modify users (Required)
- Consult leaves (Optional - for Time Off Announcements)
- Make absence requests (Optional - for Time Off Announcements)
6
Enter your email address as the Technical contact.
7
Select 'Third-party publisher' as the API key usage.
8
Click 'Generate a new API key'.
Step 3: Configure Role Permissions
1
On the API Keys page, click 'Role administration' for your new key.
2
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)
3
Save your role configuration.
Enter Credentials into Doozy
You must be a Doozy admin to connect an HRIS integration.
1
Go to the Doozy web app.
Navigate to Workspace Settings → Integrations → HRIS.
2
Choose Lucca as the HRIS you want to connect.
3
Tenant URL: Enter the base URL from Step 1.
4
API Key: Enter the API key from Step 2.
5
Click Submit.