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

# Odoo

## Connection <a href="#connect" id="connect"></a>

[Connections](https://docs.getmesa.com/going-further/credentials) give secure access to the integrated app in a MESA workflow. Your Odoo connection safely connects your workflows to your Odoo account.

To connect Odoo with MESA, you'll need to enter your Username and Password, Domain, and possibly your Database.

<figure><img src="/files/x0XxtjQVKnRhaNUWeY3R" alt="Screenshot of the Odoo connection form in a MESA workflow step. Spotlight the Username, Password, Domain, and Database fields."><figcaption></figcaption></figure>

### Adding your Username and Password

{% stepper %}
{% step %}
Locate the Username and Password by clicking Settings from your Odoo Apps page.

<figure><img src="/files/t9P4hTtfPR3eStkEhDux" alt="Screenshot of the Odoo Apps page. Spotlight the Settings option used to locate the Username and Password."><figcaption></figcaption></figure>
{% endstep %}

{% step %}
From Settings, locate General Settings and then Users. Click on Manage Users.

<figure><img src="/files/XJEl1CHntySgSKRBuSKe" alt="Screenshot of Odoo General Settings under the Users section. Spotlight the Manage Users link."><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Next, click the checkbox next to the user to whom you want to connect with MESA. Then, click on Actions (gear icon) and then Change Password.

<figure><img src="/files/h1IwnyH2Uc1HwCOJjqHd" alt="Screenshot of the Odoo Manage Users list with a user checkbox selected and the Actions gear menu open. Spotlight the Change Password action."><figcaption></figcaption></figure>
{% endstep %}

{% step %}
If your user doesn't have a password, create a new one, copy it, and click Change Password.\
\
Then, paste the newly created password into the Password field of the Odoo step in MESA. Next, copy the User Login email and paste it into the Username field of the same step.

If a password already exists, copy the User Login email and paste it into the Username field in the Odoo Connection section of your Odoo step in MESA. Then, copy the existing password and paste it into the Password field in the same step.

<figure><img src="/files/5a32DG6jarNRig0XhDsd" alt="Screenshot of the Odoo Change Password dialog showing the User Login email and password field. Spotlight the Change Password button."><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Adding your Domain <a href="#configuring" id="configuring"></a>

{% stepper %}
{% step %}
Your domain can be found in the URL of your Odoo account. For example, your domain will look like <https://mycompany.odoo.com>.
{% endstep %}

{% step %}
Paste your domain in the Domain field of the Odoo Connection menu of your Odoo step in MESA.

<figure><img src="/files/NFAHmToqeDpXYg8KzO60" alt="Screenshot of the Odoo Connection menu in the MESA Odoo step. Spotlight the Domain field where the Odoo account URL is pasted."><figcaption></figcaption></figure>

{% hint style="info" %}
Be sure to add the domain without a / at the end of the URL.
{% endhint %}
{% endstep %}
{% endstepper %}

### Adding your Database <a href="#configuring" id="configuring"></a>

If the Odoo database name differs from the domain itself, you can enter it in the Database field of the Odoo Connection section of your Odoo step in MESA. If not, ignore that field.

<figure><img src="/files/oYd6FGvEaIYQa92EG9hn" alt="Screenshot of the Odoo Connection section in the MESA Odoo step. Spotlight the Database field."><figcaption></figcaption></figure>

## Configure <a href="#configuring" id="configuring"></a>

All versions of Odoo and Odoo Online are supported, along with Sales and Contact apps

Click the Retrieve Fields button to pull in the current fields associated with your Odoo action.

<figure><img src="/files/C6vFwkxHCatk7acSQlLD" alt="Screenshot of the Odoo action Configure menu in MESA. Spotlight the Retrieve Fields button."><figcaption></figcaption></figure>

If you’ve updated your fields in Odoo, you will need to click the Retrieve Fields button to pull in the latest changes.

### Custom Model Actions <a href="#model" id="model"></a>

<figure><img src="/files/kVPiEerh5w26WVvRpNaJ" alt="Screenshot of the Odoo Custom Model actions available in the MESA workflow builder. Spotlight the Custom Model action list."><figcaption></figcaption></figure>

In MESA, you'll find several Odoo Custom Model actions. These are useful for working with Odoo objects that MESA doesn’t currently support as built-in actions. After selecting a Custom Model action, you can specify the object you want to interact with.

A common example is the [Send Shopify Customer to Odoo Contact template](https://www.getmesa.com/templates/sync-shopify-order-and-customer-to-odoo), where Custom Model actions retrieve the corresponding Odoo codes for a customer's country and state (res.country and res.state, respectively).

{% hint style="info" %}
View Odoo templates and tutorials [here](https://www.getmesa.com/apps/odoo/integrate)!
{% endhint %}