Odoo integration

Leebry connects to your Odoo instance using its standard external API authentication with API keys. The integration currently provides read-only access and uses AI to answer questions based on data stored in your Odoo database.

To connect Odoo to Leebry, you have to provide the following information:

• Base URL of your Odoo instance
• Database name
• Email address of the Odoo user that Leebry will use
• API key for that user

Before setting up the integration, make sure that:

• You can sign in as an Odoo user with sufficient permissions to access the data Leebry should analyze.

• Your Odoo version supports API keys (available under Preferences > Account Security).

• You have permissions to create and manage API keys for the selected user account.

Base URL

The Base URL is the address used to access your Odoo instance in a web browser, for example:

• https://yourcompany.odoo.com
• https://erp.example.com

If you use a custom domain, the URL address you use to access Odoo is also the base URL for that database.

To find the base URL:

1. Sign in to your Odoo account.

2. Copy the part of the URL address that includes the protocol, domain name, and optional port, but not the path.

   For example, if the URL address is https://erp.example.com/web#action=123, the base URL is https://erp.example.com.

3. Enter this value in Leebry.

Database name

Each Odoo instance uses a database with a unique technical name. Leebry requires this name to authenticate through Odoo's external API.

To find the database name:

1. Sign in to your Odoo account.

   Make sure you're signed in as an administrator of the database you want to connect.

2. Click your profile icon, then choose My Databases.

   

3. Copy the database name exactly as shown and enter it in Leebry.

User email

Leebry connects to Odoo as a dedicated user. The data available to Leebry is limited to what that user has permission to access.

Recommendations:

• Create or use a dedicated service account (for example, [email protected]) to keep integration permissions separate and easy to audit.

• Make sure this user has read access to all modules and records that Leebry should analyze.

To find the email address:

1. In Odoo, go to Settings > Users.

2. Open the appropriate user profile.

3. Copy the value from the Email or Login field.

4. Enter this value into Leebry.

API key

Leebry authenticates using an Odoo API key instead of the user's password. Treat the API key as a password and store it securely.

To generate an API key:

1. Sign in to the Odoo account that Leebry will use (for example, [email protected]).

2. Click your profile icon in the top-right corner and choose Preferences.

3. Go to the Account Security tab.

4. Under API Keys, click New API Key.

5. Enter your current Odoo password when prompted.

6. Enter a description, such as "Leebry integration", then click Generate Key.

   Odoo displays the generated API key only once.

7. Copy the API key and store it securely.

   Important

   If the API key is lost, it can't be viewed again. You have to generate a new key and update the connection in Leebry.

8. Click Done.

9. Enter the generated API key in Leebry.

Because the integration currently operates in read-only mode, it's recommended to:

• Use a dedicated service account instead of a personal user account.

• Grant only the permissions required for Leebry to analyze your data (for example, read access to Sales, Invoicing, Inventory, CRM, and other required modules).

• Avoid granting administrator or configuration permissions unless they're required.

Configure these permissions using the standard Odoo user and group management features in Settings > Users.

After collecting the required information:

1. In the Leebry admin dashboard, go to Integrations.

2. Click Connect next to Odoo.

3. Enter the following information:

   • Base URL — for example, https://erp.example.com
   • Database Name — the technical name of your database
   • Email — the Odoo user account that Leebry will use
   • API Key — the key generated under Preferences > Account Security > API Keys

   

4. Click Connect.

• Treat the API key as you would a password. Don't share it or store it in unsecured locations.

• If you believe the API key has been compromised, delete it from the user's API Keys list, generate a new one, and reconnect the integration using the new key.