Odoo integration: six routes, and the plan each one needs
Other software reads and writes Odoo through its external API, called JSON-2 since version 19.0. Odoo offers that API only on its Custom plan. Odoo's own links to carriers, payment firms, banks and marketplaces start inside Odoo, so they are not the external API. An API key you make by hand lasts at most 3 months, so every link needs a plan for new keys.
Which Odoo integration route fits the job?
Pick the route by where the job starts and which plan you run. A job that ends at a carrier, a bank, a card firm or a marketplace uses Odoo’s own connector. Another system that must read or write Odoo records uses JSON-2 on the Custom plan, with one bot user and one key per link. A system that only needs to hear about a change gets a webhook from an automation rule. An AI agent works through the MCP server. A rule that must run inside Odoo goes in a module.
Scroll the table sideways to see every column.
| Route | What it does | Plan or hosting it needs | Fits |
|---|---|---|---|
| Odoo’s own connectors | Carriers, payment firms, bank feeds, Amazon and other marketplaces | No external API; bank feeds need an Enterprise subscription | Labels, card payments, bank lines, marketplace orders |
| JSON-2 external API | Other software reads and writes Odoo records over HTTP | Custom plan only | A CRM, store or data warehouse that must read or write Odoo |
| Webhooks and automation rules | Odoo sends or takes a POST when a record changes | Rules made in Studio or developer mode; Execute Code upkeep costs extra | Telling another system an order is confirmed |
| MCP server | An outside AI agent reads or changes Odoo data | Not stated in Odoo’s MCP docs | AI agents that work in Odoo |
| Middleware such as n8n | Ready-made steps for common records | Custom plan, since it calls the external API | Small flows on contacts and CRM leads |
| Custom module | Python code that runs inside Odoo | Odoo.sh or your own server, never Odoo Online | Rules that must live inside Odoo |
The external API is JSON-2, and only the Custom plan has it
Odoo’s docs say the external API is on the Custom plan only. One App Free and Standard do not get it. n8n’s docs for its Odoo node say the same thing. So the first question for any link from another system is which plan you run.
Here is how a JSON-2 call works, from Odoo’s docs:
- It is a POST of a JSON object to
/json/2/<model>/<method>. JSON-2 is new in version 19.0. - It carries an API key as a bearer token in the Authorization header.
- Odoo checks every call against that user’s access rights, record rules and field access.
- Each call runs in its own SQL transaction, and calls cannot be chained into one. Odoo’s answer is to call one method that does all the related work, such as a sales order’s
action_confirm, which checks the order before it confirms it. Where no such method exists, Odoo says to write one in a module. - Models, fields and methods differ per database, and each database lists its own on its /doc page, so we map fields from your database’s list rather than from a generic one.
API keys and the bot user
Plan the keys before the build. A key you make by hand lasts at most 3 months, and the link stops when it lapses. Code can make up to 10 keys per user unless an admin raises the limit. Past that, the call fails with HTTP 422.
Odoo’s docs advise one key per service or integration, so each can be checked and revoked alone. Give the bot user only the rights it needs, which limits the harm if its key leaks. Its password can be empty, which turns off password login. By default, only users with the Settings admin right can manage keys from code.
The old XML-RPC routes have removal dates
Odoo’s docs call /xmlrpc, /xmlrpc/2 and /jsonrpc deprecated. The db service is already gone in Odoo 20. Two services remain: common, where an XML-RPC client signs in, and object, which the Odoo 17 and 18 docs use to call model methods. Both go in Odoo 22, due in fall 2028. On Odoo Online they go sooner, in version 21.1, due in winter 2027.
So an integration built from the Odoo 17 or 18 docs talks XML-RPC. Move it to JSON-2 before your database reaches Odoo 22, or 21.1 on Odoo Online.
Hosting sets the clock. Odoo Online makes a database on a major version upgrade every 2 years. If you take no action by the due date, Odoo runs the upgrade itself. On Odoo.sh, after three years of standard support, you get another two years to finish the upgrade. A database on your own server can stay on one version for good, though Odoo does not advise it.
Your plan decides which routes are open
We searched Odoo’s Apps Store on 18 November 2026. With version 20.0 picked, a search for “connector” returned 2,572 apps. With the Odoo Online filter on, the same search across all versions returned 0. The filter itself works. With no search term, it returned 123 apps.
That fits Odoo’s docs. Odoo Online cannot run custom modules or modules from the Apps Store. The Standard plan runs only on Odoo Online. The Custom plan can run on Odoo Online, on Odoo.sh or on your own server. So a connector app from the store means the Custom plan, hosted on Odoo.sh or by you.
Odoo’s own connectors cover shipping, payments, banks and marketplaces
These links start inside Odoo. Odoo’s pricing page says a call that starts from Odoo is not the external API. It names payment providers, carriers and bank sync as calls that are “part of the standard plan”.
- Shipping. DHL Express, Envia.com, FedEx, UPS, US Postal Service, Sendcloud, Bpost, EasyPost, Shiprocket and Starshipit. Each connector can check an address, work out the shipping cost and make the label. Other DHL services are not supported.
- Payments. Stripe, PayPal, Adyen and Authorize.net are among the built-in providers. Odoo hands card data to the provider, so Odoo says you do not worry about PCI rules.
- Bank feeds. Over 26,000 banks and other financial firms, through Plaid in the US and Canada, Yodlee and Ponto in Europe, and Salt Edge worldwide. The service needs an Enterprise subscription. Some banks let Odoo fetch only three months back; older lines can be imported.
- Amazon. Confirmed FBA and FBM orders come into Odoo, and stock for FBM items goes back to Amazon. Fee reports, disputes and refunds stay in Seller Central.
- Shopee, Lazada and TikTok Shop. Odoo 20 has a connector for each. Each brings confirmed orders into Odoo and sends available stock back.
We found no Shopify connector in the Odoo 20 docs we read. A Shopify link is one of the other routes on this page.
Webhooks and automation rules carry events
Odoo can take a POST from another system through a Studio webhook, then run a set action. It can also send one. The Send Webhook Notification action posts the field values you pick to a URL when a rule fires. Rules can be made in Studio, in developer mode or from a kanban stage.
- Rules fire on 5 kinds of trigger: Values Updated, Email Events, Timing Conditions, Custom and External.
- A webhook that creates a record, not just updates one, needs the Execute Code action. Odoo says upkeep of that code is not in the Standard or Custom plan and costs extra.
- Time-based rules run every 4 hours by default. Any rule with a delay under 40 hours makes the job run more often, such as every 18 minutes.
- The Log Calls option keeps a history of the requests sent to a webhook’s URL.
- Odoo’s own AI agents, when an automation rule starts them, create or update records without asking for approval first.
A webhook suits “tell the warehouse the order is confirmed.” To read data back, the other system still needs the API.
The MCP server is the route for outside AI agents
MCP, the Model Context Protocol, is a standard way for an AI agent to call a system’s tools. Odoo’s MCP server lets an outside agent read or change data in a database. The address is the database URL plus /mcp. Odoo’s docs name Claude Code, Antigravity and Codex as agents that can use it.
- OAuth is the sign-in Odoo recommends. It works only for internal users, so portal users need an API key made with the MCP scope.
- Only approved AI clients can ask for access. Odoo warns that Dynamic Client Registration lets any app register.
- Tools include Get Models, Search, Read group, Create Records and Update Records. The last two change data.
Odoo’s own AI features are a separate matter. Installing Odoo’s AI app on the Standard plan moves you to the Custom plan, and each request to Odoo’s AI spends In-App Purchase credits. Odoo’s MCP docs do not say whether calls from an outside agent spend credits. Our page on Odoo AI agents shows where Odoo’s own agents stop and a custom agent starts.
Middleware such as n8n works inside the same limits
Middleware is a hosted tool that moves data between apps with ready-made steps. n8n’s Odoo node covers 4 record types: Contact, Custom Resource, Note and Opportunity. Its docs list no other record types, so sales orders, vendor bills, stock moves and products would go through Custom Resource. For that, n8n lists only create, delete, get and update, with no way to call a method such as confirming an order.
n8n’s docs also say its Odoo node needs the Custom plan. So middleware saves build time on simple flows. It does not get you round the plan.
A custom module puts the logic inside Odoo
A module is Python code that runs inside Odoo itself. It cannot run on Odoo Online, so it lives on Odoo.sh or on your own server.
Odoo.sh is Odoo’s own cloud for this. You sign in with a GitHub account and get development, staging and production branches. Staging databases are deleted after a month, so keep integration test data in a form you can load again.
Modules add work at each upgrade, because Odoo’s docs say a database with custom modules cannot be upgraded until each module has a version for the target release. Our team has delivered modules built for one business problem and added to the ERP a company already runs.
Our team has taken Odoo live
Our team has taken Odoo live. For Odoo with QuickBooks, our Odoo and QuickBooks integration page covers both the sync and the move. For the setup itself, see Odoo implementation. For AI work across your systems, see AI integration services.
Questions
How do I do API integration with Odoo?
Check the plan first, because Odoo's external API works only on the Custom plan. Then make a bot user with only the rights the job needs and give it its own API key. Each call is a JSON POST to /json/2/ plus the model and method, with the key as a bearer token. Each database lists its models and fields on its /doc page. A key made by hand lasts at most 3 months, so plan the swap.
Does Odoo have a REST API?
Odoo has an HTTP API that works much like one. JSON-2, new in version 19.0, takes a JSON object posted to a URL that names the model and the method. A good call returns status 200 and the result as JSON. A failed one returns a 4xx or 5xx status with an error object. Every call names a method, such as confirming a sales order. Older versions use XML-RPC, which Odoo now marks as deprecated.
What is the disadvantage of using Odoo for integration?
The plan gate. Odoo's pricing page puts Studio, agentic AI and the external API on the Custom plan only. Odoo Online cannot run custom modules or apps from the Apps Store. Odoo Online also makes a database on a major version upgrade every 2 years, and Odoo runs the upgrade itself if you wait past the due date. So each link needs a test at every upgrade.
Can Odoo connect to CAD software?
Not out of the box, as far as Odoo's docs show. Odoo's PLM app covers engineering change orders, version control and approvals for bills of materials. Its PLM page names no CAD connector, and PLM does not come with the Manufacturing app; you install it on its own. A CAD link is a custom build. Our team built a multi-agent RFQ system in ERPNext that reads drawings and CAD files; our case studies page covers it.
Which shipping carriers does Odoo connect to?
Odoo's docs list connectors for DHL Express, Envia.com, FedEx, UPS, US Postal Service, Sendcloud, Bpost, EasyPost, Shiprocket and Starshipit. Each can check that a carrier delivers to an address, work out the shipping cost and print the label. For DHL, only DHL Express is supported. These calls start inside Odoo, and Odoo's pricing page says such calls are not the external API but part of the standard plan.
Will our XML-RPC integration keep working?
For now. Odoo's docs call the XML-RPC and JSON-RPC endpoints deprecated, and the db service is already gone in Odoo 20. The common service, where a client signs in, and the object service, which calls model methods, go in Odoo 22 (fall 2028). On Odoo Online they go sooner, in version 21.1 (winter 2027). Move the integration to JSON-2 before your database reaches either one.
Sources
Every source behind a figure or a vendor fact on this page, with the day we read it.
- Odoo 20 documentation, External JSON-2 APIRead 18 Nov 2026
- Odoo 20 documentation, External RPC APIRead 18 Nov 2026
- Odoo, PricingRead 18 Nov 2026
- Odoo 20 documentation, Odoo OnlineRead 18 Nov 2026
- Odoo Apps Store, search for connector, version 20.0Read 18 Nov 2026
- Odoo Apps Store, search for connector, Odoo Online filterRead 18 Nov 2026
- Odoo Apps Store, Odoo Online filter with no search termRead 18 Nov 2026
- Odoo 20 documentation, Third-party shipping carriersRead 18 Nov 2026
- Odoo 20 documentation, Bank synchronizationRead 18 Nov 2026
- Odoo 20 documentation, TikTok Shop connector featuresRead 18 Nov 2026
- Odoo 20 documentation, Shopee Connector featuresRead 18 Nov 2026
- Odoo 20 documentation, Lazada Connector featuresRead 18 Nov 2026
- Odoo 20 documentation, WebhooksRead 18 Nov 2026
- Odoo 20 documentation, Automation rulesRead 18 Nov 2026
- Odoo 20 documentation, AI server actionsRead 18 Nov 2026
- Odoo 20 documentation, MCP serverRead 18 Nov 2026
- Odoo 20 documentation, MCP toolsRead 18 Nov 2026
- Odoo 20 documentation, UpgradeRead 18 Nov 2026
- Odoo 20 documentation, Product lifecycle managementRead 18 Nov 2026
- n8n docs, Odoo nodeRead 18 Nov 2026
- n8n docs, Odoo credentialsRead 18 Nov 2026
Pages in this section
- Odoo and QuickBooksA QuickBooks Online sync with Odoo needs Odoo's Custom plan plus an Apps Store app or an outside service. Moving the books into Odoo ends the sync.
Bring your list of Odoo links to a first call
Bring the systems Odoo must talk to and the Odoo plan you run, and we can go through the route that fits each link. The first call is free.