Back to Integrations

Connect Odoo to ToppFive

Follow these steps to generate an API key in your Odoo account. This gives ToppFive's AI assistant secure access to your Odoo data.

Prerequisites

You'll need:

  • An Odoo user account with Administrator access (or at least API access permissions)
  • Your Odoo instance URL (e.g. https://mycompany.odoo.com)
1

Generate an API Key

  1. Log in to your Odoo instance
  2. Click your user avatar (top-right corner) and select My Profile or Preferences
  3. Scroll down to the Account Security section
  4. Click New API Key
  5. Enter a description like ToppFive AI and confirm
  6. Odoo will display your API key — copy it immediately

Important: Copy the API key now!

The API key is only shown once. If you lose it, you'll need to generate a new one.

2

Find Your Instance URL

Your instance URL is the address you use to access Odoo in your browser.

Odoo Online (SaaS):

https://mycompany.odoo.com

Self-hosted Odoo:

https://odoo.yourcompany.com

Make sure to include https:// at the beginning.

3

Find Your Database Name (Optional)

For Odoo Online (SaaS) instances, the database name usually matches the subdomain of your URL. For example, if your URL is https://mycompany.odoo.com, your database name is likely mycompany.

For self-hosted instances, you can find the database name by navigating to your Odoo's database manager (usually at /web/database/manager) or by checking your Odoo configuration file.

Tip: If you only have one database on your Odoo instance, you can leave this field blank — it will be auto-detected.

4

Connect in ToppFive

  1. Go to the Integrations page
  2. Find the Odoo card and click Connect
  3. You'll be redirected to a secure connection page where you'll enter your API Key, Instance URL, and optionally the Database Name
  4. After entering your credentials, you'll be redirected back to ToppFive

You'll be asked for:

API Key

The key you generated in Step 1

Instance URL

Your Odoo URL from Step 2 (e.g. https://mycompany.odoo.com)

Database Name (optional)

Usually the subdomain for SaaS instances

Once connected, your AI assistant will have access to your Odoo data — invoices, expenses, inventory, bank statements, and more.

Troubleshooting

“Invalid API Key” error

Make sure you copied the full API key. API keys in Odoo are long strings — check that you didn't accidentally cut off part of it.

“Cannot connect to instance” error

Verify your Instance URL is correct and includes https://. For self-hosted instances, ensure your server allows external API access and isn't blocked by a firewall.

“Database not found” error

If you have multiple databases on your instance, make sure to specify the correct database name. Check your Odoo database manager at /web/database/manager for available databases.

API Key option not visible

API keys require Odoo 14.0 or later. If you're on an older version, check with your administrator about upgrading. On Odoo Online (SaaS), API keys are always available under Preferences → Account Security.

Lost your API Key

If you've lost your API key, you can generate a new one from Preferences → Account Security → New API Key. The old key will continue to work until you delete it.

Need help? Reach out to us and we'll walk you through the setup.

Contact Support