Skip to main content
Admin access to your Lucca account is required to create integration keys. Integration keys are not copied to sandboxes, so create one in each environment you link.

​
Find Your Lucca Address

Your Lucca address gives the subdomain and the environment to connect.

1

Read the subdomain and domain

Open Lucca in your browser and look at the address bar. The subdomain is the text before the first dot and the domain is the rest. For https://acme.ilucca.net, enter acme and pick Production (Europe) - ilucca.net. For a sandbox at https://acme-qa.sandbox.eu1.luccasoftware.com, enter acme-qa and pick Sandbox (EU1).

​
Create Integration Keys

Create OAuth 2.0 credentials in your Lucca account to enable API access.

1

Access Integration Keys

Navigate to the integration keys management page in your Lucca account.

  • Log in to your Lucca account
  • Go to Settings > Identity > Integration Keys
  • Or navigate directly to /identity/admin/integration-keys
2

Create a New Integration

Create a new integration application.

  • Click Add integration key
  • Enter a technical contact email
  • Provide a name for the application (e.g., “StackOne Integration”)
3

Configure Scopes

Enables actions: Create A Department, Create A Job-position, Create A Probationary-period, Create A Taxonomy, Create A Taxonomy-label, Create A Webhook-endpoint, Create An Employee, Create An Employee-attribute, Create An Employee-attribute-definition, Create An Employment, Delete A Job-position, Delete A Probationary-period, Delete A Taxonomy, Delete A Taxonomy-label, Delete A Webhook-endpoint, Delete An Employee-attribute-definition, Delete An Employment, List Business-establishments, List Departments, List Employee-attribute-definitions, List Employee-attributes, List Employee-personal-records, List Employees, List Employment-templates, List Employments, List Events, List Job-positions, List Job-qualifications, List Legal-entities, List Occupation-categories, List Probationary-periods, List Professions, List Taxonomies, List Taxonomy-labels, List Webhook-deliveries, List Webhook-delivery-attempts, List Webhook-endpoints, List Working-time-arrangements, Replace A Taxonomy, Replace A Taxonomy-label, Replace An Employee-attribute, Replace An Employee-attribute-definition, Retrieve A Business-establishment, Retrieve A Department, Retrieve A File, Retrieve A Job-position, Retrieve A Job-qualification, Retrieve A Legal-entity, Retrieve A Probationary-period, Retrieve A Profession, Retrieve A Taxonomy, Retrieve A Taxonomy-label, Retrieve A Webhook-delivery, Retrieve A Webhook-delivery-attempt, Retrieve A Webhook-endpoint, Retrieve A Working-time-arrangement, Retrieve An Employee, Retrieve An Employee-attribute, Retrieve An Employee-attribute-definition, Retrieve An Employee-personal-record, Retrieve An Employment, Retrieve An Employment-template, Retrieve An Event, Retrieve An Occupation-category, Trigger A Test Delivery, Update A Department, Update A Job-position, Update A Probationary-period, Update A Taxonomy, Update A Taxonomy-label, Update A Webhook-endpoint, Update An Employee, Update An Employee-attribute, Update An Employee-attribute-definition, Update An Employee-personal-record, Update An Employment, Upload A File

Select the OAuth scopes your integration needs.

4

Select Establishments

Choose which business establishments the integration can access.

  • Select the establishments you want the integration to access
  • Or select all establishments for full access
5

Copy Credentials

Copy and store your credentials securely.

  • Copy the Client ID
  • Copy the Client Secret immediately — it will not be shown again
  • Enter both in StackOne, with the space-separated scopes you granted in OAuth Scopes
1

Connect

  • Click Connect.
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup.
2

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.

​
Next Steps

Webhooks setup

Configure receiving Events for Lucca into StackOne.