Skip to main content
Lucca
Betav3.4.0
50 actions · 12 events · 2 auth methods
HRIS

​
Getting Started

1

Create or Select a Project

Set up a new project or select an existing one. See Organizations & Projects.
2

Configure the Connector

Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.

OAuth 2.0 · Connector Profile

OAuth 2.0 Client Credentials flow for the Lucca API (v5). Recommended for new integrations.

API Key · Connector Profile

Legacy API key authentication for Lucca v3/v4 APIs. Each key has role-based access rights.
Optionally, configure receiving Events for Lucca into StackOne.

Webhooks setup

3

Link an Account

Link an account from the dashboard (or via StackOne Hub).See the guide for the authentication type chosen in the Connector Profile:

OAuth 2.0 · Link Account

API Key · Link Account

4

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.

​
Actions

|
|
50 actions
Action
Description
Required scopes
List Employees
Returns a paginated list of employees.
Retrieve An Employee
Retrieve a single employee.
Retrieve/Download A Portrait
Retrieve a single employee portrait, either as a JSON representation, or the actual image file.
Download A Portrait
Download the image file of a single employee portrait.
List Employee-personal-records
Retrieve a paginated list of employee-personal-records.
Retrieve An Employee-personal-record
Retrieve an employee-personal-record.
Create An Employee (legacy V3, API Key)
Create a new employee (user) in Lucca through the legacy v3 API, with role IDs, using API Key authentication.
Create An Employee
Create a new employee with their first employment and first job position.
List Departments
Returns a paginated list of departments.
Retrieve A Department
Retrieve a single department by ID.
Create A Department
Create a new department.
Update A Department
Update a department.
List Legal-entities
Returns a paginated list of legal-entities.
Retrieve A Legal-entity
Retrieve a legal-entity.
List Business-establishments
List business-establishments.
Retrieve A Business-establishment
Retrieve a business-establishment.
List Employments
Returns a paginated list of employments.
Retrieve An Employment
Retrieve an employment by its ID.
List Employment-templates
Retrieve a paginated list of employment-templates.
Retrieve An Employment-template
Retrieve an employment-template by its ID.
List Job-positions
Retrieve a paginated list of job-positions.
Retrieve A Job-position
Retrieve a job-position by its ID.
List Probationary-periods
List probationary-periods.
Retrieve A Probationary-period
Retrieve a probationary-period by its ID.
List Employee-attribute-definitions
Returns a paginated list of employee-attribute-definitions.
Retrieve An Employee-attribute-definition
Retrieve a single employee-attribute-definition by ID.
List Employee-attributes
Returns a paginated list of employee-attributes.
Retrieve An Employee-attribute
Retrieve a single employee-attribute by ID.
List Professions
List professions.
Retrieve A Profession
Retrieve a profession by its ID.
List Job-qualifications
Returns a paginated list of job-qualifications.
Retrieve A Job-qualification
Retrieve a job-qualification by its ID.
List Occupation-categories
Returns a paginated list of occupation-categories.
Retrieve An Occupation-category
Retrieve an occupation-category.
List Taxonomies
Returns a paginated list of taxonomies.
Retrieve A Taxonomy
Retrieve a taxonomy by its ID.
List Taxonomy-labels
Returns a paginated list of taxonomy-labels.
Retrieve A Taxonomy-label
Retrieve a taxonomy-label by its ID.
Upload A File
Upload a file in order to reference it as the attachment of another resource (e.g. a portrait).
Retrieve A File
Retrieve a file, either its JSON representation or its content.
List Webhook-endpoints
Returns a paginated list of webhook-endpoints.
Create A Webhook-endpoint
Create a new webhook-endpoint.
Retrieve A Webhook-endpoint
Retrieves a single webhook-endpoint resource.
Update A Webhook-endpoint
Update an existing webhook-endpoint.
Delete A Webhook-endpoint
Delete an existing webhook-endpoint.
List Webhook-deliveries
Returns a paginated list of webhook-deliveries.
Trigger A Test Delivery
Triggers a test delivery to a webhook endpoint to verify it is configured correctly.
Retrieve A Webhook-delivery
Retrieve a webhook-delivery.
List Webhook-delivery-attempts
Retrieve a paginated list of webhook-delivery-attempts.
Retrieve A Webhook-delivery-attempt
Retrieve a webhook-delivery-attempt.

​
Events

|
12 events
Event
Description
Tags
Employee Created
Processes Lucca employee.created events when a new employee is added.
EmployeesWebhooks
Employee Updated
Processes Lucca employee.updated events when an employee is modified.
EmployeesWebhooks
Employee Deleted
Processes Lucca employee.deleted events when an employee is removed.
EmployeesWebhooks
Employment Created
Processes Lucca employment.created events when a new employment is added.
EmploymentsWebhooks
Employment Updated
Processes Lucca employment.updated events when an employment is modified.
EmploymentsWebhooks
Employment Deleted
Processes Lucca employment.deleted events when an employment is removed.
EmploymentsWebhooks
Job Position Created
Processes Lucca job-position.created events when a new job position is added.
Job PositionsWebhooks
Job Position Updated
Processes Lucca job-position.updated events when a job position is modified.
Job PositionsWebhooks
Job Position Deleted
Processes Lucca job-position.deleted events when a job position is removed.
Job PositionsWebhooks
Employee Extension Created
Processes Lucca employee-extension.created events when a custom attribute value is added.
Employee AttributesWebhooks
Employee Extension Updated
Processes Lucca employee-extension.updated events when a custom attribute value is modified.
Employee AttributesWebhooks
Employee Extension Deleted
Processes Lucca employee-extension.deleted events when a custom attribute value is removed.
Employee AttributesWebhooks