Do you want to learn interactively all basics related to the creation of an API export, or how to make an advanced setup for an API in Channable? Learn how to create a Channacademy account in the Channable app through this Help Center article and start with the Basic APIs or Expert APIs course.
A number of API's used by Marketplaces have connections with expiration periods that, if not refreshed in time, can disrupt your API and order connections, leading to a break in the link between Channable and your Marketplace. Moreover, if you notice signs of a faulty connection, refreshing your connection is a good troubleshooting step. Here we explain how to refresh your connections to prevent these issues.
Table of contents
- Effects of an expired or faulty connection
- Affected Marketplaces
- Types of notifications
- Refreshing your existing API connection
Effects of an expired or faulty connection
When a connection expires, the following issues will occur:
- Items/Ads: Your items and ads will not be updated on the Marketplace, leading to outdated product information and potential sales losses.
- Other changes: Any other modifications made to your product listings will not be reflected on the Marketplace.
- Orders: Orders will be blocked and won't appear in Channable or your webshop, as they rely on the same connection.
When you encounter a faulty connection, similar issues can arise, although they may not be as immediately obvious as those caused by an expired connection. Faulty connections can result in:
- Intermittent updates: Items and ads may update sporadically or not at all, causing inconsistencies in your listings.
- Partial data transfer: Only some changes might get through, leading to incomplete or incorrect product information.
- Order processing issues: Orders might not sync properly, leading to delays or missing orders in your system.
Affected Marketplaces
Below is a table of the Marketplaces, that expire after a certain period, according to their API documentation, important to note is that the frequency can change if the Marketplace decides to do so.
| Marketplace | Expiration Frequency |
|---|---|
| Amazon | 1 year |
| eBay | 18 months |
| Marktplaats | Varies |
| Bol.com | 1 year |
| Wish | Varies |
| Afosto | Varies |
| Microsoft Ads | Varies |
| Google Analytics | Varies |
| Google Shopping | Varies |
| 2dehands.be/2ememain | Varies |
| AliExpress | Varies |
| Miravia | 2 years |
Types of notifications
We have two types of ways to inform you when an API connection is expired.
- Expiration indicator: A small tag on the connection page indicates when the connection will become invalid. Note that currently, this feature is available for 3 Marketplaces: Bol, eBay, and AliExpress.
- Email notifications: Users receive emails when the API fails, the API will get a "Failed" label.
Refreshing your existing API connection
Before refreshing your connection we have a couple of important notes listed below:
- Log in with the same seller account used when creating the initial connection.
- Use incognito mode to ensure you are prompted to log in to your seller account, preventing the browser from logging into the wrong account.
When the information is clear, proceed with refreshing the connection.
-
Navigate to "APIs" and click on the API you want to refresh the connection for, or navigate to the "Connections" page on the company level.
-
Click on the connection image on the "Settings" page of the API. or "Edit" on the "Connections" page.
- Select "Refresh connection" in the lower right corner.
- A pop-up will appear asking if you are sure you want to refresh the connection.
- Click "Refresh connection" to proceed.
- You will be redirected to the Marketplace environment to log in or confirm access in the Marketplace environment. After confirming, you will be redirected back to Channable.
- Click "Refresh connection" one last time to complete the process.
Congratulations! Your connection has been refreshed.