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

# Odoo

Odoo is an open-source suite of integrated business applications, CRM, Sales, Invoicing, Inventory, Purchase, Accounting, Projects, HR, and more, that many companies run as their core ERP. Connecting Odoo to Stacksync lets your workflows read and write records across any of these apps, so you can automate operations and keep Odoo in sync with the rest of your business systems.

## Connect Odoo

Connect your Odoo instance and start using it with Stacksync.

### Requirements

* An Odoo account with **external API access** enabled
  * On **Odoo Online**, external API access requires the **Custom** pricing plan. Odoo.sh and self-hosted instances have no plan restriction.
* Permission to generate an **API key** for your Odoo user

***

#### 1. Create a new connection

In Stacksync, click **Create a new connection**.

<figure><img src="https://3057949906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDSqHwwR8lD3JUWz3E9NH%2Fuploads%2FKh5x8XRu7moSDz5hYN8h%2Fimage.png?alt=media&amp;token=350437e9-de0e-43ea-8e88-9168c8971ae4" alt=""><figcaption></figcaption></figure>

***

#### 2. Select Odoo

Click the **Odoo** logo from the list of connectors.

<figure><img src="https://3057949906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDSqHwwR8lD3JUWz3E9NH%2Fuploads%2FuasrrjFncjaKSaqOPfOk%2Fimage.png?alt=media&amp;token=8ea1c41e-7a7d-449e-a1c9-31119e5acb64" alt=""><figcaption></figcaption></figure>

***

#### 3. Gather your connection details

In the following steps, you will collect four values from your Odoo account:

* **Instance URL**
* **Database**
* **Username**
* **API Key**

***

#### 4. Find your Instance URL and Database

Your **Instance URL** is your Odoo web address, up to the domain only — no page path.

* Example: `https://mycompany.odoo.com`
* Copy it from your browser's address bar and remove anything after `.com` (e.g. drop `/web#...`).

Your **Database** name:

* On **Odoo Online**, it is the subdomain of your URL — for `https://mycompany.odoo.com`, the database is `mycompany`.
* On **Odoo.sh / self-hosted**, use your database name (ask your Odoo administrator if unsure).

> **Tip:** Paste only the domain (`https://mycompany.odoo.com`), not the full page URL.

***

#### 5. Find your Username

Your **Username** is the login email of the Odoo user the connection will act as.

* Click your **profile avatar** (top-right) → **Preferences** (or **My Profile**).
* Your email address shown there is your username.

***

#### 6. Generate your API Key

1. Click your **profile avatar** (top-right) → **Preferences**.
2. Open the **Account Security** tab.
3. Click **New API Key**.
4. Re-enter your password when prompted to confirm.
5. Enter a description (for example, `Stacksync`) and generate the key.
6. **Copy the key immediately** — Odoo shows it only once and it cannot be retrieved later.

> **Read vs. write access:** A read-only key is enough for read-only workflows. For creating, updating, or deleting records, use a **full-access** key. If writes are rejected with a "read access only" message, your Odoo administrator needs to enable full API access for your user.

> **Recommended:** Use a dedicated integration user (for example, `integrations@yourcompany.com`) rather than a personal login, so actions are clearly attributed and don't depend on one person's account.

***

#### 7. Fill in the Stacksync form

Enter the four values into the connection form:

<figure><img src="https://3057949906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDSqHwwR8lD3JUWz3E9NH%2Fuploads%2FtVB5Tm8xKyTJLK1PspYS%2Fimage.png?alt=media&amp;token=d5780488-3b05-41fa-be56-8a7a402d3af7" alt=""><figcaption></figcaption></figure>

| Field            | Value                             |
| ---------------- | --------------------------------- |
| **Instance URL** | `https://mycompany.odoo.com`      |
| **Database**     | `mycompany`                       |
| **Username**     | `user@mycompany.com`              |
| **API Key**      | *the key you generated in step 6* |

Click **Connect**.

***

#### You are all set! 🎉

Your Odoo connection is ready to use in your Stacksync workflows.