Skip to main content
Partner: Lucca (HR system)

Connect Teamtailor with your Lucca account

Theo avatar
Written by Theo
Updated over 2 weeks 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, where you you add the activation key which combines the three following things:

  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.illuca.net/api/v3||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. 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

Email

Candidate's email

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?