Prerequisites
The connector should already be set up, with a Connector Profile and a Linked Account. See Getting Started on the Lucca connector page.How the subscription is created
StackOne creates and manages the webhook endpoint in Lucca automatically. It is created when the account is linked, subscribed to the events you select in StackOne, and deleted when the account is disconnected. There is nothing to configure in Lucca.
Grant the webhook scope to the integration key
StackOne creates the endpoint with the account’s own integration key, so the key must be allowed to manage webhook endpoints.
- In Lucca, open the integration key used for this account at
/identity/admin/integration-keys - Grant webhook-endpoints.readwrite, plus the read scope of each resource you want events for (for example employees.readonly, employments.readonly, job-positions.readonly, employee-attributes.readonly)
- Add webhook-endpoints.readwrite to OAuth Scopes on the linked account in StackOne
Leave the endpoint unchanged in Lucca
The endpoint StackOne creates is listed at https://{subdomain}.ilucca.net/integrations/endpoints (use your own Lucca domain), and every delivery attempt is logged at /integrations/deliveries. Editing or deleting the endpoint there stops events until you reconnect the account in StackOne.
Reconnect after a suspension
Lucca suspends an endpoint that keeps failing to receive deliveries. If events stop arriving and the endpoint shows as suspended in /integrations/endpoints, reconnect the account in StackOne to create a new endpoint.
Available webhook events
The following Lucca events can be received. Only events selected in StackOne are included in the subscription — Lucca does not deliver events that are not subscribed.
Employee events
Events related to employees.
- Employee Created (
employee.created) — Fired when a new employee is added - Employee Updated (
employee.updated) — Fired when an employee’s own attributes change, such as their name, email or status
Employment events
Events related to employments, the contracts that link an employee to a legal entity.
- Employment Created (
employment.created) — Fired when a new employment is added, including the first employment created with a new employee - Employment Updated (
employment.updated) — Fired when an employment changes, such as its end date or template - Employment Deleted (
employment.deleted) — Fired when an employment is deleted
Job position events
Events related to job positions, an employee’s role, department, establishment and manager within an employment.
- Job Position Created (
job-position.created) — Fired when a new job position is added, including the first job position created with a new employee - Job Position Updated (
job-position.updated) — Fired when a job position changes, such as its job title, department or manager - Job Position Deleted (
job-position.deleted) — Fired when a job position is deleted