# Odoo + Lutril: setup guide

> Lutril connects to Odoo through the External JSON-2 API with a bearer API key: it lists internal and portal users, creates accounts for approved access requests (Odoo emails the invitation itself), and archives accounts on offboarding.

Source: https://www.lutril.com/integrations/odoo
Category: ERP
Auth: api_key
Last verified: 2026-08-04

---

## Setup

1. Sign in to Odoo as a user with Settings (administration) access. A dedicated service account is recommended so the key survives employee offboarding.
2. Open your avatar menu, then Preferences, then the Account Security tab, and click New API Key.
3. Enter a description (for example Lutril) and a duration, confirm your password, then copy the key: Odoo shows it only once.
4. In Lutril, open the Odoo integration and paste your base URL (for example https://mycompany.odoo.com), the database name if your server hosts several, and the API key.
5. Note: the external API requires an Odoo Custom pricing plan and the JSON-2 endpoint requires Odoo 19 or newer.

## Access requested

- res.users: search_read (list users and their status)
- res.users: create (provision users on approved requests)
- res.users: write (archive users on offboarding, never deleted)

## References

- [Odoo documentation](https://www.odoo.com/documentation/19.0/developer/reference/external_api.html)
- [External JSON-2 API reference](https://www.odoo.com/documentation/19.0/developer/reference/external_api.html)
- [Odoo pricing (external API requires the Custom plan)](https://www.odoo.com/pricing)