The complete guide
Odoo integration: the complete guide
Updated November 18, 2026 · Published by Danny Rathod, Founder, StackLift AI. Written with AI assistance; how we make content.
Short answer
An Odoo integration reads and writes Odoo models, such as sale orders, partners, and products, from outside systems through its external API, authenticated with a per-user API key. How hard it is depends on which apps you installed, how much custom code the instance carries, which edition you run, and where it is hosted.
What do teams connect Odoo to?
Odoo is a suite of apps that share one database: CRM, Sales, Inventory, Accounting, Purchase, Website, and more. A company may adopt only a few and keep other tools for the rest. Integration keeps those tools and Odoo agreeing with each other.
- Create sale orders and contacts from an outside storefront.
- Keep product catalogs and on-hand quantities aligned with a marketplace.
- Open CRM leads from a marketing form.
- Reflect Odoo invoice and delivery status inside a customer account area.
- Push posted accounting data to a reporting database.
Which Odoo API should you call?
Odoo exposes its models to external callers. The long-standing routes are XML-RPC and JSON-RPC, where you name a model and a method and pass arguments. Recent releases introduce a JSON-2 style endpoint that uses ordinary HTTP conventions, and Odoo's documentation points toward it for new work, with the older routes slated for retirement. Dates have shifted, so read the notes for your exact version.
Users create API keys in their account security settings. A key stands in for the user's password and carries that user's access rights, which makes a dedicated integration user the safe pattern. Access to the external API on Odoo Online is tied to the plan you hold, so verify it before designing around it. See the API glossary entry for the basics.
How do hosting and edition change things?
Odoo can run as Odoo Online, on Odoo.sh, or on servers you manage, and it comes in Community and Enterprise editions. Each combination decides whether you can install your own modules, how you get a test copy, and who handles upgrades.
| Setup | Custom modules | Where to test |
|---|---|---|
| Odoo Online | Generally not installable, so work stays outside | A duplicate database, if your plan allows |
| Odoo.sh | Yes, from your repository | Staging branches built from production data |
| Self-hosted | Yes, you control the add-ons path | A separate server or container you create |
Treat the table as a checklist for your first call with the Odoo administrator, not as a promise about every plan.
Which Odoo records move, and which way?
| Model area | Direction | Trigger |
|---|---|---|
| Sale orders and lines | Into Odoo | Checkout or quote acceptance |
| Partners (customers, vendors) | Into Odoo, matched by email or reference | First contact |
| Products and variants | Mostly out of Odoo | On catalog change |
| Stock quantities | Out of Odoo | Scheduled poll |
| Customer invoices | Out of Odoo | Once posted |
| CRM leads | Into Odoo | Form submission |
What pushes an Odoo project up in effort?
The typical effort shown above describes a lightly customized database. Plan for more when you see:
- Third-party or in-house modules that add required fields or change validation.
- Studio changes and automated actions that fire on write.
- Product variants built from attributes, plus several units of measure.
- Multi-company setups with separate chart of accounts and fiscal rules.
- Several warehouses and routes, or a manufacturing app.
- An upgrade to a new major version in the middle of the project.
The CRM and ERP cost guide shows how these factors move budgets.
What commonly fails in Odoo integrations?
- Building on the old RPC routes without checking when your version retires them.
- Using an administrator's key, so a bug in the integration can touch everything.
- Writing a sale order with a product that has variants and picking the template instead of the variant.
- Ignoring computed and onchange behavior, so totals differ from what the Odoo screen would produce.
- Looping over records one call at a time, which crawls on large imports.
- Testing only on a fresh database that lacks the production customizations.
Connector, community module, or custom code?
Zapier and Make offer ways to reach Odoo, and the Odoo app store lists connectors for popular platforms. Check that any option supports your version and edition.
| Option | Good for | Watch for |
|---|---|---|
| iPaaS scenario | Alerts and single-record creation | Per-task fees and thin error handling |
| Packaged connector for a platform | A common store-to-Odoo pattern | Version support and how it treats your custom fields |
| Custom service calling the API | Orders, stock, accounting with retries | You own the upkeep |
| Custom Odoo module | Logic that must live inside Odoo | Not possible on every hosting option |
The iPaaS glossary entry explains the category.
How should you go live?
- Get a staging database that matches production, including modules.
- Create an integration user and give it only the access groups it needs.
- Agree how products, variants, taxes, and units match between systems.
- Test a refused write, a revoked key, and a repeated request.
- Backfill a copy and have the people who use Odoo check the numbers.
- Rerun the flows after any planned version upgrade.
- Release one flow first, with alerts on, and keep a rollback ready.
How does StackLift scope an Odoo job?
StackLift integrates with Odoo as an independent team. Discovery records your version, edition, hosting, installed apps, and custom code, and a senior architect reviews the scope before it becomes a commitment. Build it up feature by feature in the free estimate.
Work stays on feature branches, agents never handle production secrets, and the plan includes CI/CD, observability, and rollback from the first sprint.
Questions people ask
How do I get an Odoo API key?
A user creates one in their account security settings. Odoo shows it once, so store it in a secret manager. Use a dedicated integration user.
Is XML-RPC still the way to integrate with Odoo?
It still works on many versions, but Odoo steers new work toward its JSON-2 interface. Confirm what your version supports before you choose.
Can I install my own module on Odoo Online?
Typically not. That is one reason hosting matters, so confirm with Odoo for your plan.
Is Odoo or ERPNext easier to integrate?
Neither wins in general. Customization and hosting dominate, so compare using the ERPNext page and your own setup.
How long does an Odoo integration take?
Most first versions take 6 to 16 weeks depending on scope. A 3-day Scope Sprint gives you a detailed plan first.