Skip to main content
Generating API keys requires the Lucca role Roles and API Key management. API keys only work with the legacy v3/v4 actions; use OAuth 2.0 (Client Credentials) for the Lucca API (v5) actions and webhooks.

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

Generating an API Key

Generate an API key from your Lucca account settings.

1

Navigate to API Keys

From your Lucca dashboard:

  • Open the Settings menu (cog icon)
  • Go to Authentication, SSO and API > API keys
2

Create a New API Key

Create a new API key for the integration.

  • Click Generate a new API Key
  • Enter a descriptive name (e.g., “StackOne Integration”)
3

Grant access through the key's role

Lucca creates a role with the same name as the key. Open it in Role administration and grant the permissions the legacy actions need, such as reading users, absences or timesheets.

4

Copy the API Key

Copy the API key immediately and store it securely.

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.