Skip to main content

​
What’s supported

​
Supported actions

This connector supports:
  • Read Actions, including full historic backfill and incremental read.
  • Write 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. 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.

​
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.
Odoo API Key For more details, see the Odoo Authentication documentation.

​
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.
  • If you are using Read Actions, create a destination.
  • Embed the InstallIntegration UI component. The UI component will prompt the customer for an API key.
  • Start using the connector!
    • If your integration has Read Actions, you’ll start getting webhook messages.
    • If your integration has Write Actions, you can start making API calls to our Write API.
    • If your integration has Proxy Actions, you can start making Proxy API calls.