Lucca OAuth 2.0 connector profile – StackOne setup guide

Set up the OAuth 2.0 connector profile for Lucca in StackOne. One-time admin setup required before your users can link Lucca accounts via Hub.

Admin access to your Lucca account is required to create integration keys.

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 Webhook-endpoint, Delete A Webhook-endpoint, List Business-establishments, List Departments, List Employee-attribute-definitions, List Employee-attributes, List Employee-personal-records, List Employees, List Employment-templates, List Employments, 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, 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 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 Occupation-category, Retrieve/Download A Portrait, Trigger A Test Delivery, Update A Department, Update A Webhook-endpoint, Upload A File

   Select the OAuth scopes your integration needs.

   • employees.readonly⧉
   • employees.readwrite⧉
   • departments.readonly⧉
   • departments.readwrite⧉
   • legal-entities.readonly⧉
   • business-establishments.readonly⧉
   • employments.readonly⧉
   • employments.readwrite⧉
   • employment-templates.readonly⧉
   • job-positions.readonly⧉
   • job-positions.readwrite⧉
   • probationary-periods.readonly⧉
   • employee-personal-records.readonly⧉
   • employee-attribute-definitions.readonly⧉
   • employee-attributes.readonly⧉
   • job-qualifications.readonly⧉
   • occupation-categories.readonly⧉
   • taxonomies.readonly⧉
   • taxonomies.readwrite⧉
   • files.readonly⧉
   • files.readwrite⧉
   • webhook-endpoints.readonly⧉
   • webhook-endpoints.readwrite⧉
   • webhook-deliveries.readonly⧉
   • webhook-deliveries.readwrite⧉
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
   • Store both values securely

Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Lucca:

1. Navigate to Connector Profiles

   Login to StackOne and navigate to Connector Profiles

2. Create New Connector Profile

   • Click + Connector Profile
   • Search for and select Lucca
   • Select Type as OAuth 2.0

   • Fill out the fields using details retrieved from your provider:

     • Client ID
     • Client Secret
     • OAuth Scopes (Optional)
   • (Optional) Select Actions to be enabled for this Connector Profile
   • Click Create profile

Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Lucca.