# Lucca + Lutril: setup guide

> Lutril lit votre annuaire Lucca via le flux OAuth 2.0 client credentials. Vous créez une clé d’intégration dans Lucca pour obtenir un Client ID et un Client Secret, et vous renseignez votre hôte Lucca.

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

---

## Setup

1. Connectez-vous à votre compte Lucca avec un administrateur habilité à gérer les intégrations.
2. Ouvrez la page d’administration des clés d’intégration, au chemin /identity/admin/integration-keys sur votre hôte Lucca (par exemple https://votreentreprise.ilucca.net/identity/admin/integration-keys).
3. Créez une nouvelle application cliente : saisissez un e-mail de contact technique et un nom d’application.
4. Sélectionnez les scopes OAuth listés ci-dessus et les établissements auxquels l’application peut accéder, puis enregistrez.
5. Copiez le Client ID et le Client Secret générés (le secret n’est affiché qu’une fois) et saisissez-les dans Lutril.
6. Renseignez votre hôte Lucca dans Lutril (par exemple votreentreprise.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)
- [Guide d’authentification](undefined)
- [Générer une clé d’API](undefined)