---
title: How to integrate with Lucca
description: Lucca integration guide
---
[Skip to content](https://help.ravio.com/lucca#main-content)
English
Show submenu for translations
Open main navigation
Close main navigation
- English
Show submenu for translations
- [Contact us](https://fa3fd.share-eu1.hsforms.com/2IkfMVpstTUWvffP5uESSLg)
[Contact us](https://fa3fd.share-eu1.hsforms.com/2IkfMVpstTUWvffP5uESSLg)
How can we help you?
- There are no suggestions because the search field is empty.
1. [Ravio Help Centre](https://help.ravio.com/?hsLang=en)
2. [Integrations and data sharing](https://help.ravio.com/integrations-and-data-sharing?hsLang=en)
3. [Setting up your HRIS integration](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#setting-up-your-hris-integration)
# How to integrate with Lucca
## A step by step guide detailing how to set up an integration between Ravio and Lucca
### Prerequisites
The primary prerequisite to be able to set this integration up is **your account must have "Admin" rights.** Here's how you can check if you have these rights:
- Log in to your Lucca account and navigate to the upper right corner of the screen and click on the "gear" icon and navigate to **“API Keys”**:
If this section is not appearing you are not an Admin user in Lucca. If this is the case, please reach out to the person in your organisation that does have these rights to continue setting up this integration.
### Step by Step Instructions
#### Ravio App on Lucca Marketplace
Ravio now has an official app on the Lucca Marketplace! If you wish to use this please follow the steps listed here:
- [https://support.lucca.fr/hc/en-us/articles/8547420248220-Ravio-via-Kombo-A-real-time-pay-solution](https://support.lucca.fr/hc/en-us/articles/8547420248220-Ravio-via-Kombo-A-real-time-pay-solution)
Once the API Key is generated, skip to [Step 4](https://www.notion.so/Lucca-d96f5a6789294141aa4b2de584f90bd3?pvs=21) of the instructions below.
#### Custom API Key
### Step 1 - Creating a new API Key in Lucca
Navigate to the API Keys page as per the above and click ‘Generate a new API key’.
To generate an API key, follow these steps:
1. Enter a name of your choice for your API key under "**Key name**".
2. To create a key, you must select at least one permission. We recommend you to select "**Co-workers → Consult / create / modify users**" and “**Timmi Absences → Consult Leaves**”. This is just temporary as we will be fine tuning the permissions at the next step.
3. Enter an email address of someone in the IT or HR department that's responsible for this integration under “**Technical Contact**”.
4. Select "**Internal Use**" under "**API Key Usage**"
5. Click on “**Generate new API key**”.
You should now see your API Key newly created on the API Keys page:
### Step 2 - Enter this information in Ravio
Now switch into the Ravio app to start the onboarding workflow. Once selecting the Lucca HR system you will be prompted to add your Lucca domain which can be found in your URL bar.
Once you have entered this information, paste the newly created API Key into the required section and hit continue.
This will bring up the next page which tells you which permissions the Ravio app will require.
### Step 3 - Fine tuning the API Key permissions
Continuing through the process as above will bring you to the next page in Ravio which details the permissions that the API Key will require to make sure Ravio has all the information required to properly benchmark your company.
The first step is to navigate back to your API Key in Lucca, and select ‘Role Administration’.
This brings up the role permissions screen where you should navigate to the API Key we just created by searching for the name in the search box in the top left of the screen and making sure this is selected.
Then we need to make sure the permissions that Ravio requires are all added. As an example, if we want to add the permission “Pagga Compensation → Access Individual Situations”, we would find Pagga Compensation in the permissions list and hit the + button to open up the individual accesses.
Once this is done we would just tick the box for the required permission, and click Save.
This would then be repeated for all of the permissions that Ravio requires. You can find a full list of the required and recommended permissions below.
| Permission Category | Detailed Permissions | Requiredness |
| --- | --- | --- |
| Pagga Compensation | Access individual situations | Required |
| | Access to the payroll variables grid (only for variable pay use cases) | Optional |
| Timmi Office | See the schedule | Required |
| Co-workers | Read users Lucca properties | Required |
| | View employee jobs | Required |
| | Consult contractual information of employees | Required |
| | See former / future employees | Optional |
| Poplee Performance | View reviews of | Optional |
### Step 4 - Updating this information in Ravio
Once this last step is completed, you can go back to Ravio and select ‘Set up integration’. If everything is done correctly you should see a Success message, if not please go to ‘Troubleshooting’ below.
### 
- [Getting started](https://help.ravio.com/getting-started?hsLang=en#main-content)
- [Onboarding](https://help.ravio.com/getting-started?hsLang=en#onboarding)
- [Benchmarking](https://help.ravio.com/getting-started?hsLang=en#benchmarking)
- [Pay equity](https://help.ravio.com/getting-started?hsLang=en#pay-equity)
- [Video guides](https://help.ravio.com/getting-started?hsLang=en#video-guides)
- [Using Ravio with AI tools](https://help.ravio.com/getting-started?hsLang=en#using-ravio-with-ai-tools)
- [Integrations and data sharing](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#main-content)
- [Setting up your HRIS integration](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#setting-up-your-hris-integration)
- [Variable and equity data](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#variable-and-equity-data)
- [Manually sharing employee data](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#manually-sharing-employee-data)
- [Setting up your ATS integration](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#setting-up-your-ats-integration)
- [Managing your integration](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#managing-your-integration)
- [Video guides](https://help.ravio.com/integrations-and-data-sharing?hsLang=en#video-guides)
- [Ravio feature guides](https://help.ravio.com/ravio-feature-guides?hsLang=en#main-content)
- [Salary bands](https://help.ravio.com/ravio-feature-guides?hsLang=en#salary-bands)
- [Explore the market](https://help.ravio.com/ravio-feature-guides?hsLang=en#explore-the-market)
- [Employee mapping & levelling](https://help.ravio.com/ravio-feature-guides?hsLang=en#employee-mapping-levelling)
- [Manage my data](https://help.ravio.com/ravio-feature-guides?hsLang=en#manage-my-data)
- [Settings](https://help.ravio.com/ravio-feature-guides?hsLang=en#settings)
- [Analyse your company](https://help.ravio.com/ravio-feature-guides?hsLang=en#analyse-your-company)
- [EU Pay Transparency](https://help.ravio.com/ravio-feature-guides?hsLang=en#eu-pay-transparency)
- [User and access management](https://help.ravio.com/user-and-access-management?hsLang=en#main-content)
- [User permissions](https://help.ravio.com/user-and-access-management?hsLang=en#user-permissions)
- [Single Sign On (SSO)](https://help.ravio.com/user-and-access-management?hsLang=en#single-sign-on-sso)
- [Benchmarking and data confidence](https://help.ravio.com/benchmarking-and-data-confidence?hsLang=en#main-content)
- [Data](https://help.ravio.com/benchmarking-and-data-confidence?hsLang=en#data)
- [Troubleshooting and support](https://help.ravio.com/troubleshooting-and-support?hsLang=en#main-content)
- [Contact support](https://help.ravio.com/troubleshooting-and-support?hsLang=en#contact-support)
- [FAQ](https://help.ravio.com/faq?hsLang=en#main-content)
- [Billing and invoices](https://help.ravio.com/faq?hsLang=en#billing-and-invoices)
- [Compliance](https://help.ravio.com/faq?hsLang=en#compliance)
- [Ravio community](https://help.ravio.com/faq?hsLang=en#ravio-community)
- [Sales](https://help.ravio.com/faq?hsLang=en#sales)
- [Integrations](https://help.ravio.com/integrations?hsLang=en)
- [Uncategorized](https://help.ravio.com/uncategorized?hsLang=en)
- Home
- Products
- Pricing
- Blog
- Company
[](http://ravio.com)
[mailto:hello@ravio.com](mailto:hello@ravio.com)
Copyright © 2026, Ravio Technologies Ltd