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 action | Frequency |
|---|---|
Channable: import orders | Every 15 minutes |
Channable: push pending shipments | Every 15 minutes |
Channable: import returns | Every 30 minutes |
Channable: push stock updates | Every 30 minutes |
Channable: publish feeds on FlexigoTech Cloud | Every hour |
Channable: pull channel statistics | Every day |
Channable: API token expiry check | Every 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.

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 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
| Message | When it appears | What 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
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
