Amazon requires all users to update their API to V2. After April 1, 2025, we can’t guarantee full functionality for Amazon V1 in Channable.
What happens if I don’t migrate?
Starting April 1, 2025
- Channable will no longer be able to provide technical and troubleshooting support for your Amazon V1 API.
- Full functionality for V1 won’t be guaranteed.
- You’ll be working with an outdated data model.
Starting June 30, 2025
- Amazon V1 will stop working entirely.
- Any updates you make to your product listings in Channable (e.g. stock information, price, content) will not sync to your listings.
- Customers won’t see changes to your listings, and we can’t guarantee they’ll appear on Amazon.
- Missed updates could lead to listing downtime and lost sales.
To avoid disruptions, migrate to Amazon V2 before June 30* and attempt to resolve potential issues independently before contacting Support.
*This deadline is determined by Amazon and may change
May 2025
Update to Amazon's data model
On May 25, Amazon implemented some changes to their data model. This may have consequences for the attributes you need to map for your Amazon channel.
You can find the complete list of changes here.
March 2025
What's new with the latest update?
Listing Requirement Levels
Amazon V2 introduces listing requirement levels to determine the level of information you need to provide for your product listings.
This is automatically set to ‘Offer and product’, but you can change this manually in the Settings step of your Amazon API.
| Listing requirement level | Description | Use case | Action needed |
| Offer and product | The default and most commonly used option. It sends core product information (e.g. title, description, images) and offer details (e.g. price, stock, shipping) simultaneously. Selecting this level creates a new product listing on Amazon. |
|
|
| Offer only | This level is solely focused on the offer-related data of a product. It "attaches" your offer to an existing product listing on Amazon without sending core product details. | When selling products already listed on Amazon. |
|
| Product |
This level creates a new product listing on Amazon, but the product isn't available for sale until offer details are added. Choose this level to send core product details, such as title, description, and images, without including offer information like price and stock. |
|
|
Conditional requirements
Amazon V2 introduces conditional requirements. Conditional requirements make certain fields mandatory if related data is included.
For example, if you specify Capacity, you must also provide Capacity Unit.
You can find conditional requirements in the Build step in the ‘Shared attributes’ and ‘Category-specific attributes’ tabs.
- Shared Attributes: Common fields for all products and offers (e.g. EAN, prices, titles).
- Category-Specific Attributes: Fields relevant to specific categories (e.g. size for clothing, dimensions for furniture).
Dry runs
The Dry run feature tests your API without sending actual data to Amazon. It checks if your API is configured correctly by checking which products or offers currently exist in your Amazon account and comparing them to your Channable listings.
To perform a dry run:
- In [Your Amazon API], go to the Settings step.
- Click Start dry run now.
You can review the results of your dry run by navigating to the Matched items tab in the Preview step.
Matched items
The new ‘Matched items’ tab in the Preview step provides a detailed view of how your imported items in Channable align with your Amazon listings.
Channable matches items using Unique ID per item and Seller SKU.
| Channable | |
| Field | Description |
| Unique ID per item | This pulls data from the ID you mapped in the Settings step of your Amazon API. |
| Item ID |
This is the external product ID entered in the Build step. Note: This may not match the item ID in the Amazon tab. |
| Seller SKU |
The corresponding identifier on Amazon. |
| Amazon | |
| Field | Description |
| Listing status | Shows the current state of your product listings. (i.e. whether your product is live on Amazon or not) |
| Listing name | The name of your listing as it appears on Amazon |
| ASIN | The Amazon Standard Identification Number (ASIN) of your products. Click on this to view the listing. |
Filter items by Status
You can filter the listed items by their current status on Amazon:
| Status | Description |
| Active | This item is live on Amazon. |
| Inactive | This item isn’t live on Amazon yet, but is available in your account. |
| Incomplete | These items are missing required information |
| No match found | There is no link between the Channable item and any existing Amazon listing. This can happen if the product doesn’t exist in your Amazon inventory, or an incorrect or mismatched Unique ID or Seller SKU. |
You can also download your results as a CSV file. At the ‘All’ dropdown menu, select the items you want to filter by status and click Download as CSV.