Skip to main content

Lucca integration

Connect your Lucca HRIS to Figures to retrieve your pay data.

Updated over a week ago

Prerequisites

Please read the following carefully to ensure you meet all the requirements to set up the integration:

To set up the integration with Lucca, your user roles must include:

  • Other > Lucca > Roles and API Key management

To check if you have this role:

  1. In the top right corner of the screen, click the cog icon.

  2. Select API keys.

    (the screenshots can be mistranslated as they are AI generated)

  3. Ensure you can see the Generate a new API Key button.

If you cannot follow these steps, you do not have the necessary permissions to set up the integration. Please contact your system administrator to assign the Roles and API Key management role to your account.

Instructions

Creating API key

  1. Log in to Lucca.

  2. Navigate to the top right corner of the screen and click on the "cog" icon, then “Authentification, SSO ans API”, finally on “API keys”:

  3. Click on "Generate a new API Key" button to create an API key:

  4. To generate an API key use the following steps:

    1. Enter a name of your choosing for your API key under "Key Name".

    2. In order to create a key, you need to select at least one permission. We recommend you to select "Collaborator -> View/create/edit users", and don't worry, you can fine tune the permission later.

    3. Enter an email address of someone in the IT or HR department that's responsible for this integration.

    4. Select "Internal usage" under "API Key usage"

    5. Click "Generate a new API Key" button.

  5. You can find your newly created API key by the name that you had entered earlier. In this example, we just created "Integration API 1728285214671". Then click on "roles administration":

  6. In the "Roles" page, locate your API key by its name ("Integration API 1728285214671" in this case) in the sidebar on the left side of the screen, and click on it.

Setup the right permissions

  1. Once you clicked on your API key, click on “Permissions” then make sure the “Talent” is open, and clock on “Collaborator”

  2. Select all the permissions below

    1. View the directory and organisational chart - All departments

    2. View personnel files

    3. View Lucca data for employees

    4. View employee positions

    5. View employee managers

    6. View employee qualifications

    7. View employee contract information

  3. ⚠️This section is only applicable if you have Pagga Rem⚠️ Click on “Pagga Rémunération” under the “Pay” section, and select the following rights:

    1. View individual situations

    2. Access the EVP screen

    3. View deleted remuneration

Link your Lucca account with your Figures Account

Now that your API key is properly configured, we need your specific Lucca domain and the API key

  1. You can find your domain in the URL bar (in the form of https://example.ilucca.net)

  2. Paste it in the Figures integration form

  3. Go back in the “API Keys” section from the beginning of this guide, you can click on “API keys” as shown in the screenshot below:

  4. Find your API key, and click on the icon right next to your key to copy it

  5. Paste it in the “**Lucca API key ***” in Figures’ form, and click on the “save” button.

Related Articles
Update your employee data manually
Hibob Integration
Granting Figures access to Managers
Connect your HRIS
Add, delete and update employees via spreadsheet
Did this answer your question?