> ## Documentation Index
> Fetch the complete documentation index at: https://ampersand-24eb5c1a-odoo-deep.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Odoo

## What's supported

### Supported actions

This connector supports:

* [Read Actions](/read-actions), including full historic backfill and incremental read.
* [Write Actions](/write-actions).
* [Proxy Actions](/proxy-actions), using the base URL `https://{{.workspace}}`, where `workspace` is your Odoo instance domain (e.g., `mycompany.odoo.com`).

### Supported objects

The Odoo connector supports reading from and writing to Odoo models accessible via the [JSON-2 API](https://www.odoo.com/documentation/19.0/developer/reference/external_api.html). Models are referenced by their technical name in the `objectName` field of your manifest (e.g., `res.partner`, `crm.lead`, `sale.order`).
Which models are available depends on the modules installed on the customer's Odoo instance. Common examples include:

* `res.partner` (Contacts)
* `crm.lead` (Leads/Opportunities)
* `sale.order` (Sales Orders)
* `account.move` (Invoices/Journal Entries)
* `product.product` (Products)
* `project.task` (Tasks)

### Example integration

For an example manifest file of an Odoo integration, visit our [samples repo on GitHub](https://github.com/amp-labs/samples/blob/main/odoo/amp.yaml).

## Before You Get Started

To use the Odoo connector, you'll need an API Key from your Odoo account. Here's how to get it:

1. Sign in to your Odoo instance, then open Preferences.
2. Open the Account security tab.
3. In the API Keys section, click New API Key.
4. Enter a description and set a duration.
5. Click Generate Key, then copy the API Key.

<img src="https://mintcdn.com/ampersand-24eb5c1a-odoo-deep/_OzNkLeRTOz4crpN/images/provider-guides/odoo.gif?s=30cdfc636260ad410f91f8a5c379792a" alt="Odoo API Key" width="800" height="450" data-path="images/provider-guides/odoo.gif" />

For more details, see the [Odoo Authentication documentation](https://www.odoo.com/documentation/19.0/developer/reference/external_api.html#configuration).

## Using the connector

This connector uses API Key authentication, which means that you do not need to set up a Provider App before getting started. (Provider apps are only required for providers that use OAuth2 Authorization Code grant type.)

To integrate with Odoo:

* Create a manifest file like the example above.
* Deploy it using the [amp CLI](/cli/overview).
* If you are using Read Actions, create a [destination](/destinations).
* Embed the [InstallIntegration](/embeddable-ui-components#install-integration) UI component. The UI component will prompt the customer for an API key.
* Start using the connector!
  * If your integration has [Read Actions](/read-actions), you'll start getting webhook messages.
  * If your integration has [Write Actions](/write-actions), you can start making API calls to our Write API.
  * If your integration has [Proxy Actions](/proxy-actions), you can start making Proxy API calls.