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, Download A Portrait, 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.
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
Open the connector
Log in to StackOne, open Connectors, and select Lucca.
2
Choose actions and events
- Click Add Profile.
- If the connector offers more than one authentication method, set the Auth Method filter to OAuth 2.0.
- Select the actions, and any events, to enable for this Connector Profile.
- Click Continue.
3
Set up authentication
- Select Authentication Type as OAuth 2.0.
- Fill out the fields using details retrieved from your provider:
- Client ID
- Client Secret
- OAuth Scopes (Optional)
- Click Create Profile.