> For the complete documentation index, see [llms.txt](https://docs.n8n.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.n8n.io/integrations/builtin/credentials/odoo.md).

# Odoo credentials

You can use these credentials to authenticate the following nodes:

* [Odoo](/integrations/builtin/app-nodes/n8n-nodes-base.odoo.md)

## Supported authentication methods <a href="#supported-authentication-methods" id="supported-authentication-methods"></a>

* API key (Recommended)
* Password

## Related resources <a href="#related-resources" id="related-resources"></a>

Refer to [Odoo's External API documentation](https://www.odoo.com/documentation/17.0/developer/reference/external_api.html) for more information about the service.

Refer to the Odoo [Getting Started tutorial](https://www.odoo.com/slides/getting-started-15) if you're new to Odoo.

## Using API key <a href="#using-api-key" id="using-api-key"></a>

To configure this credential, you'll need a user account on an [Odoo](https://www.odoo.com/) database and:

* Your **Site URL**
* Your **Username**
* An **API key**
* Your **Database name**

To set up the credential with an API key:

1. Enter your Odoo server or site URL as the **Site URL**.
2. Enter your **Username** as it's displayed on your **Change password** screen in Odoo.
3. To use an API key, go to **Your Profile > Preferences > Account Security > Developer API Keys**.
   * If you don't have this option, you may need to upgrade your Odoo plan. Refer to [Required plan type](#required-plan-type) for more information.
4. Select **New API Key**.
5. Enter a **Description** for the key, like `n8n integration`.
6. Select **Generate Key**.
7. Copy the key and enter it as the **Password or API key** in your n8n credential.
8. Enter your Odoo **Database name**, also known as the instance name.

Refer to [Odoo API Keys](https://www.odoo.com/documentation/15.0/developer/reference/external_api.html?#api-keys) for more information.

## Using password <a href="#using-password" id="using-password"></a>

To configure this credential, you'll need a user account on an [Odoo](https://www.odoo.com/) database and:

* Your **Site URL**
* Your **Username**
* Your **Password**
* Your **Database name**

To set up the credential with a password:

1. Enter your Odoo server or site URL as the **Site URL**.
2. Enter your **Username** as it's displayed on your **Change password** screen in Odoo.
3. To use a password, enter your user password in the **Password or API key** field.
4. Enter your Odoo **Database name**, also known as the instance name.

{% hint style="info" %}
**Password compatibility**

If you try a password credential and it doesn't work for a specific node function, try switching to an API key. Odoo requires an API key for certain modules or based on certain settings.
{% endhint %}

## Required plan type <a href="#required-plan-type" id="required-plan-type"></a>

{% hint style="info" %}
**Required plan type**

Access to the external API is only available on a **Custom** Odoo plan. (The One App Free or Standard plans won't give you access.)

Refer to [Odoo Pricing Plans](https://www.odoo.com/pricing-plan) for more information.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.n8n.io/integrations/builtin/credentials/odoo.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.