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:

Customer URL when logged into Lucca. For eg. https://yourcompanyname.ilucca.net/
The extension: api/v3
Lucca API key
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:

Subdomain of your Lucca account when logged in. For example, for https://yourcompanyname.ilucca.net/ it would be yourcompanyname
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

Lucca Field ID	Field Name	Description	Type	Source	Mandatory Field
firstName	First Name	Employee's first name	Text	TeamTailor candidate first name	Yes
lastName	Last Name	Employee's last name	Text	TeamTailor candidate last name	Yes
mail	Professional Email	Work email address	Text	TeamTailor candidate email	Yes
personalEmail	Personal Email	Personal email address	Text	TeamTailor custom field	Yes
personalMobile	Personal Phone Number	Personal mobile phone	Text	TeamTailor candidate phone	Yes
jobTitle	Job Title	Employee's job position	Text	TeamTailor candidate job title	No
address	Address	Home address	Text	TeamTailor custom field	No
bic	BIC	Bank Identifier Code	Text	TeamTailor custom field	No
birthDate	Date of Birth	Employee's birth date	Date	TeamTailor custom field	No
civilTitle	Title	Civil title (Mr./Ms./etc.)	Text	TeamTailor custom field	No
iban	IBAN	International Bank Account Number	Text	TeamTailor custom field	No
insuranceNumber	Social Security Number	National insurance number	Text	TeamTailor custom field	No
dtContractEnd	End of Contract	Contract termination date	Date	TeamTailor custom field	No
dtContractStart	Contract Start	Contract start date	Date	TeamTailor custom field	No
employeeNumber	Payroll Number	Employee identification number	Text	TeamTailor custom field	No
seniorityDate	Length of Service Date	Date when service period started	Date	TeamTailor custom field	No
login	Username	System login username	Text	TeamTailor custom field	No
allowsElectronicPayslip	Receive Electronic Payslips	Electronic payslip preference	Checkbox	TeamTailor custom field	No
personalAccount	Third Party Account	External account reference	Text	TeamTailor custom field	No
corporateCard	External Company Card	Corporate card information	Text	TeamTailor custom field	No
frenchCarTaxHorsePower	Taxable Horsepower (Car)	Vehicle tax information	Number	TeamTailor custom field	No
gender	Gender	Employee's gender	Text	TeamTailor custom field, possible values (Mr, Ms)	No
quote	Quote	Employee quote or motto	Text	TeamTailor custom field	No
directLine	Direct Line	Direct phone number	Text	TeamTailor custom field	No
professionalMobile	Business Phone Number	Professional mobile phone	Text	TeamTailor custom field	No
bankName	Name of the Bank	Employee's bank name	Text	TeamTailor custom field	No
theoreticalRemuneration	Annual Theoretical Pay	Current annual salary	Text	TeamTailor custom field	No
fullTimeEquivalent	Working Time Quota	Full-time equivalent percentage	Text	TeamTailor custom field	No
1-cost	FR Cost Price (€/Day)	Daily cost price in euros	Number	TeamTailor custom field	No
1-price	FR Standard Selling Price (€/Day)	Daily selling price in euros	Number	TeamTailor custom field	No
lastAnnualReviewDate	Date of Last Annual Review	Most recent annual review date	Date	TeamTailor custom field	No
lastProfessionalReviewDate	Date of Last Professional Review	Most recent professional review date	Date	TeamTailor custom field	No
lastFixedWorkingDaysReviewDate	Date of Last Working Days Review	Most recent working days review date	Date	TeamTailor custom field	No
e_birthplace	Birth Place	Employee's place of birth	Text	TeamTailor custom field	No
e_Codepostal	Zip Code	Postal code	Text	TeamTailor custom field	No
e_Coefficient	Coefficient	Employment coefficient	Text	TeamTailor custom field	No
e_Complementdadresse	Addition to Address	Additional address information	Text	TeamTailor custom field	No
e_linkedIn	LinkedIn Profile	LinkedIn profile URL	Text	TeamTailor custom field	No
e_maritalstatus	Marital Status	Current marital status	Selection	TeamTailor custom field	No
e_Motifderupture	Termination Reason	Reason for contract termination	Text	TeamTailor custom field	No
e_Nomdenaissance	Birth Name	Name at birth	Text	TeamTailor custom field	No
e_phoneperso	Personal Phone	Personal phone number	Text	TeamTailor custom field	No
e_Position	Position	Current position	Text	TeamTailor custom field	No
e_transportrefund	Subscription Fee Refunded	Transport subscription refund	Text	TeamTailor custom field	No
e_trialperiod1	End Trial Period 1	First trial period end date	Date	TeamTailor custom field	No
e_trialperiod2	End Trial Period 2	Second trial period end date	Date	TeamTailor custom field	No
e_Type-d-adhesion-mutuelle	Type d'adhésion mutuelle	Health insurance membership type	Selection	TeamTailor custom field	No
e_Ville	City	City of residence	Text	TeamTailor custom field	No
e_contracttype	Type of Contract	Employment contract type	Selection	TeamTailor custom field (mapped via webhook configuration)	No
managerId	Manager	Direct manager	Selection	TeamTailor webhook configuration	No
manager2Id	Custom Leave Approver	Secondary manager for leave approvals	Selection	TeamTailor webhook configuration	No
legalEntityId	Establishment	Company legal entity	Selection	TeamTailor webhook configuration	No
departmentId	Department	Employee's department	Selection	TeamTailor webhook configuration	No
cspId	Occupation Category	Job category classification	Selection	TeamTailor webhook configuration	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.

Partner: BambooHR (HR system)

Partner: Workday (HR system)

Partner: Rotaready (HR system)

Partner: Sage HR (HR system)

Partner: hcmfront (HR system)

Partner: Lucca (HR system)

Getting Started

Set up the workflow on Teamtailor

Information sent to Lucca

Q/A