Amazon V2 updates – Help Center - Channable

ACTION REQUIRED

Amazon requires all users to update their API to V2. After April 1, 2025, full functionality for Amazon V1 in Channable is not guaranteed.

Active troubleshooting support for Amazon V1 from Channable ends April 1. To avoid disruptions, migrate to Amazon V2 before June 30* and attempt to resolve potential issues independently before contacting Support.

Note: Migrating won’t disrupt your Amazon services, so your listings will remain active. Once you migrate you can make changes to your products via the migrated Amazon V2 version of your API.

*This deadline is determined by Amazon and may change

Amazon is rolling out a new version of its API - Amazon V2. Amazon requires all users to migrate their APIs to Amazon V2 by June 31st, to ensure compatibility with Amazon’s updated systems.

To help make this change smoother for your business and meet Amazon’s requirements, we've made several updates to the API.

These updates include:

Migration assistance
New features to give you a better overview of your Amazon products

What's new?

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.

Note: Before mapping for your chosen listing requirement level, you must categorize your products. This includes the 'Offer only' requirement level.

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.	Creating new products that aren’t in Amazon's existing catalog in one API connection Making updates to products and/or your product offers	Map all mandatory product and offer information fields Ensure all products are mapped to a GTIN, EAN, ASIN or UPC
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.	Ensure all products are mapped to a unique identifier (GTIN, EAN, ASIN or UPC) Map all mandatory offer fields (e.g. price, stock, condition)
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.	When listing new products not on Amazon's catalog without sending the offer When solely making content changes to existing products	Ensure all products have a unique identifier (GTIN, EAN, ASIN or UPC.*) and make sure it’s mapped. Map all mandatory product fields (e.g. images, titles, descriptions). This is the minimum required to create products.

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.

Tip: Running dry runs is a great way to avoid errors when configuring your Amazon API. You can run a dry run as often as you’d like.

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.

Tip: Regularly check the Preview step to make sure your products are mapped correctly.