Identity (IDP) · API key

Connect Lucca to Lutril

Lutril reads your Lucca directory using the OAuth 2.0 client credentials flow. You create an integration key in Lucca to get a Client ID and Client Secret, and supply your Lucca host.

Required scope / permission

  • employees.readonly
  • job-positions.readonly
  • departments.readonly
  • legal-entities.readonly

Setup steps

  1. Sign in to your Lucca account with an administrator who can manage integrations.
  2. Open the integration keys admin page at the path /identity/admin/integration-keys on your Lucca host (for example https://yourcompany.ilucca.net/identity/admin/integration-keys).
  3. Create a new client application: enter a technical contact email and an application name.
  4. Select the OAuth scopes listed above and the business establishments the app may access, then save.
  5. Copy the generated Client ID and Client Secret (the secret is shown once) and enter them in Lutril.
  6. Enter your Lucca host in Lutril (for example yourcompany.ilucca.net).