# Lucca + Lutril: setup guide

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

Source: https://www.lutril.com/integrations/lucca
Category: Identity (IDP)
Auth: api_key
Last verified: 2026-06-17

---

## Setup

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

## Access requested

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

## References

- [Lucca documentation](https://developers.luccasoftware.com/documentation/using-api/authentication)
- [Authentication guide](https://developers.luccasoftware.com/documentation/using-api/authentication)
- [Generating an API key](https://support.luccasoftware.com/s/article/generating-an-api-key?language=en_US)