Skip to main content
Channable

Channable API from Odoo: what it needs, what the connector calls and its errors

The Channable API needs your numeric company id, an API token that expires after a year and, for some calls, the project id. FlexigoTech's connector for Odoo checks the token's expiry every day. It pulls orders every 15 minutes with the API v2 cursor and pushes stock in batches of 50 items, the API's hard limit, at 4 requests per second.

FlexigoTech · Editor in charge: Víctor Gómez · Updated 12 November 2026

Key facts

Module
Channable
Versions
Odoo 17, 18, 19 and 20
Checked
in the connector's source code, version 20.0
Reading time
4 min

What the Channable API needs to connect

  • Channable Company ID: the numeric id shown in the Channable app. It must be a positive number.
  • API token (FlexigoTech Cloud): you generate it in the Channable app (Company Settings > Channable API) and it lasts a year. It is sent once, encrypted, to FlexigoTech Cloud and is never stored in Odoo.
  • Token Expires: a reminder of when the token turns one year old.
  • The project id, also positive, for the endpoints that require a project scope.

Before the token is saved, an administrator has to tick I accept that my Channable API token and my calls to Channable go through FlexigoTech Cloud. The FlexigoTech Cloud relay keeps the token encrypted and adds it to every call.

Which Channable API calls the connector makes and how often

The connector works both ways on Channable's order connection API (api.channable.com). These scheduled actions are active from installation:

Scheduled actionFrequency
Channable: import ordersEvery 15 minutes
Channable: push pending shipmentsEvery 15 minutes
Channable: import returnsEvery 30 minutes
Channable: push stock updatesEvery 30 minutes
Channable: publish feeds on FlexigoTech CloudEvery hour
Channable: pull channel statisticsEvery day
Channable: API token expiry checkEvery day

Orders come in through incremental polling of the API v2, with the last_modified_after cursor. Each one creates a sale order with price-included taxes derived from the channel, shipping and discount lines, commission, transaction fees and the test-order flag. Amazon orders have their own guide to Channable and Amazon.

List of Channable orders in Odoo with channel, buyer, total, commission and payment and shipping status
Channable orders, with demo data.

Real stock moves flag items as pending and the connector pushes absolute stock values. A reconciliation action compares Odoo stock with Channable's live offers.

FlexigoTech Cloud hosts the product feed of each project: Odoo generates it (XML, CSV or JSON), gzips it and uploads it every hour when it changes, or on Publish feed now. Channable imports it from the hosted URL shown on the project.

Channable dashboard in Odoo with items in the feed, orders, returns, channel commissions and sync activity
The Channable dashboard with demo data.

Channable API limits and how the connector respects them

The API accepts at most 50 items per stock update. The connector pushes batches of 50 through a rate-limit-aware client: a leaky bucket of 4 requests per second. If a request carried more, the module would stop it with Channable stock updates accept at most … items per request.

For the token, the expiry check runs every day. If Channable answers with a 401 or a 403, the account moves to the Authentication error state.

Channable API connection errors and what to do

MessageWhen it appearsWhat to do
Channable refused the API token of account '…' saved in FlexigoTech Cloud (…): it is not valid, it has expired (tokens last 1 year) or it was revoked. Generate another one in the Channable app (Company Settings > Channable API) and type it in the account. Nothing was marked as failed.Channable answers with a 401 or a 403.Generate another token and type it in the account.
Channable account '…' no longer has the consent to go through FlexigoTech Cloud, so nothing was sent. Nothing was marked as failed: an administrator accepts it again on the account to resume.The account no longer has the consent to go through FlexigoTech Cloud.An administrator accepts it again on the account.
The Channable company id must be a positive number.The company id is zero or negative.Copy the id shown in the Channable app.
The Channable project id must be a positive number.The project id is zero or negative.Correct the project id.
This Channable endpoint requires a project scope.A call that needs a project goes without one.Check the project.
Before saving the API token, an administrator has to accept that the token and the calls to Channable go through FlexigoTech Cloud. Nothing was sent.The token is saved without that consent.An administrator accepts and you save again.
The API token of … is not saved in FlexigoTech Cloud: type it again.FlexigoTech Cloud does not hold that account's token.Type the token again.

Questions about the Channable API in Odoo

How often do Channable orders reach Odoo?

Every 15 minutes, through the Channable: import orders action, which polls the API v2 with the last_modified_after cursor.

Does Odoo keep a copy of the API token?

No. The FlexigoTech Cloud relay keeps it encrypted. Only an administrator can delete the token from FlexigoTech Cloud.

What do I need, and which Odoo versions does it work with?

It works with Odoo 17, 18, 19 and 20 and needs the FlexigoTech Cloud subscription, Connector plan. You will find the Channable Odoo Connector on Odoo Apps and the details on its page at flexigotech.com.

Keep reading

Channable and Amazon in Odoo: orders, the seller invoice and EasyShip labelsWhat happens in Odoo to the Amazon orders Channable brings in: the INVOICE upload, EasyShip labels, tracking, cancellations and returns.
Checked in the connector's source code (version 20.0)

Sources

  • Module source code: flexigobe_channable_connector 20.0 (6156c3b8): __manifest__.py
  • Module source code: flexigobe_channable_connector 20.0 (6156c3b8): README.md
  • Module source code: flexigobe_channable_connector 20.0 (6156c3b8): models/channable_api_client.py
  • Module source code: flexigobe_channable_connector 20.0 (6156c3b8): models/channable_account.py
  • Module source code: flexigobe_channable_connector 20.0 (6156c3b8): models/fgt_cloud.py
  • Module source code: flexigobe_channable_connector 20.0 (6156c3b8): models/channable_project.py
  • Module source code: flexigobe_channable_connector 20.0 (6156c3b8): data/channable_cron_data.xml