> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Lucca with OAuth 2.0 (Client Credentials) – StackOne Hub

> Link a Lucca account in the StackOne Hub using OAuth 2.0 (Client Credentials). End-user guide to authorize the integration and start using Lucca actions.

> [!WARNING]
>
> 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.

Select Actions to adjust the guideSome actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Select all
Clear

ActionScope(s)

Loading actions...No actions match your search.

Dynamic Guide URL

Copy URL

Scopes Selected

<pre role="textbox" aria-readonly="true" tabIndex="0" />

Separator

Copy scopes

## 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.

<ul>
  <li>Log in to your Lucca account</li>
  <li>Go to **Settings** > **Identity** > **Integration Keys**</li>
  <li>Or navigate directly to `/identity/admin/integration-keys`</li>
</ul>

**2. Create a New Integration**

Create a new integration application.

<ul>
  <li>Click **Add integration key**</li>
  <li>Enter a technical contact email</li>
  <li>Provide a name for the application (e.g., "StackOne Integration")</li>
</ul>

**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.

<ul>
  <li>
    employees.readonly
  </li>

  <li>
    employees.readwrite
  </li>

  <li>
    departments.readonly
  </li>

  <li>
    departments.readwrite
  </li>

  <li>
    legal-entities.readonly
  </li>

  <li>
    business-establishments.readonly
  </li>

  <li>
    employments.readonly
  </li>

  <li>
    employments.readwrite
  </li>

  <li>
    employment-templates.readonly
  </li>

  <li>
    job-positions.readonly
  </li>

  <li>
    job-positions.readwrite
  </li>

  <li>
    probationary-periods.readonly
  </li>

  <li>
    probationary-periods.readwrite
  </li>

  <li>
    employee-personal-records.readonly
  </li>

  <li>
    employee-personal-records.readwrite
  </li>

  <li>
    employee-attribute-definitions.readonly
  </li>

  <li>
    employee-attribute-definitions.readwrite
  </li>

  <li>
    employee-attributes.readonly
  </li>

  <li>
    employee-attributes.readwrite
  </li>

  <li>
    job-qualifications.readonly
  </li>

  <li>
    occupation-categories.readonly
  </li>

  <li>
    taxonomies.readonly
  </li>

  <li>
    taxonomies.readwrite
  </li>

  <li>
    files.readonly
  </li>

  <li>
    files.readwrite
  </li>

  <li>
    events.readonly
  </li>

  <li>
    working-time-arrangements.readonly
  </li>

  <li>
    webhook-endpoints.readonly
  </li>

  <li>
    webhook-endpoints.readwrite
  </li>

  <li>
    webhook-deliveries.readonly
  </li>

  <li>
    webhook-deliveries.readwrite
  </li>
</ul>

**4. Select Establishments**

Choose which business establishments the integration can access.

<ul>
  <li>Select the establishments you want the integration to access</li>
  <li>Or select all establishments for full access</li>
</ul>

**5. Copy Credentials**

Copy and store your credentials securely.

<ul>
  <li>Copy the **Client ID**</li>
  <li>Copy the **Client Secret** immediately — it will not be shown again</li>
  <li>Enter both in StackOne, with the space-separated scopes you granted in **OAuth Scopes**</li>
</ul>

## Link the Account

**1. Connect**

<ul>
  <li>Click **Connect**.</li>
  <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
  <li>Once authorization is successful, you will see a confirmation popup.</li>
</ul>

**2. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/connect/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Next Steps

> [card] [Webhooks setup](https://docs.stackone.com/connectors/lucca/guides/webhook-setup.md)
>
> Configure receiving Events for Lucca into StackOne.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.