Skip to main content

Partner: Lucca (HR system)

Connect Teamtailor with your Lucca account

Theo avatar
Written by Theo
Updated over a week ago

By activating our integration with Lucca, you'll be able to add triggers that automatically send candidate profiles to your Core HR platform with Lucca.

Getting Started

To enable the integration, you first have to connect your existing Lucca account through our Marketplace page. Once the integration is activated, you will be redirected to the configuration settings. Depending on whether you wish to connect your test environment or your production environment, the setup will be slightly different.

Test/sandbox environment:

  1. Customer URL when logged into Lucca. For eg. https://yourcompanyname.ilucca.net/

  2. The extension: api/v3

  3. Make sure the key has the following rights:

    • Consult Lucca data

    • Modify Lucca data

    • Modify establishments and legal units

    • Administration of departments

The activation key should have the following format:
[customerurl]/api/v3||[api_key]

For example:
https://teamtailor.ilucca.net/api/v3||123de456rf566fgder458h9883

Production environment:

  1. Subdomain of your Lucca account when logged in. For example, for https://yourcompanyname.ilucca.net/ it would be yourcompanyname

  2. Lucca API key (see instructions above)

The activation key should have the following format:
[customer subdomain]||[api_key]

For example:
yourcompanyname||123de456rf566fgder458h9883

Set up the workflow on Teamtailor

You can set up the Lucca trigger and send candidate data automatically to the Core HR platform when they are hired.

Start by going to the job where you would like to add the Lucca trigger. Click on the Triggers want at the top right-hand corner and + Add trigger in the Hired stage. Choose Send Lucca candidate to set it up.

Choose the Establishment and Department you would like the candidate to be sent to when hired. You can also select a Manager, a second one, a Contract type and an Occupation category if you wish. Finally click Add trigger to save the setup.

Now every time you move a candidate to this stage, Teamtailor will send the candidate data to your Lucca account. You will also see this action under the Lucca section on the candidate card in Teamtailor.

Information sent to Lucca

Fields in Lucca

Fetched from these fields in Teamtailor

Mandatory field

First / Last name

Candidate's first and last name

Yes

Login

Candidate's email

Yes

Professional
Email

Create Text Custom Field named: Professional Email


If not provided, Candidate's personal email will be used as fallback.

Yes

Legal Identity ID

Selected as Establishment in the trigger setup

Yes

Department ID

Selected as Department in the trigger setup

Yes

Phone

Candidate's phone number

Yes

Contract Start Date

Date Custom Field named: Contract Start Date

or

Date the integration was triggered on the candidate

No

Q/A

What happens if the candidate has the same email address as someone already in my Lucca platform?

You will need to input a different email address before initiating the trigger on Teamtailor as you cannot have duplicate entities in Lucca with the same email.

Where do I get the API Key from?

The API Key can be generated within your Lucca platform by going to Settings → API Keys → Generate API Key.

Can I update the information that is sent to Lucca?

Yes, any information that’s been sent to Lucca, can be edited on your Lucca account after being sent.

Did this answer your question?