To main website
  1. Help Center - Channable
  2. Channels - Marketplaces
  3. Amazon Marketplace

Articles in this section

See more

How to migrate an Amazon API to Amazon V2

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

Contents

Before you start

If you have multiple Amazon APIs with parent-child relationships, make sure you repeat these steps for each API. 

 

Step 1: Begin migrating your API

  1. Go to Projects > [Your project] > Channels. 
  2. Click the Settings step for the API you want to migrate.
  3. Click ⚠ Migrate your API. This opens an overview page of what we can migrate automatically, and what you need to map manually.
Attributes chart
Message Action required Description
Successful No These attributes can be migrated automatically
Automatic migration not possible Yes We can’t automatically migrate these attributes for you. Map these again manually in the ‘Shared attributes’ and ‘Attributes per category’ tabs (found in the Build step.)
No migration suggested by Amazon Yes Amazon couldn’t determine which attributes to recommend for these fields for Amazon V2. Map these fields manually and check after running the API  or contact Amazon support for help.
Empty attributes Optional These attributes were left empty in your old API

 

Categories chart
Message Action required Description
Successful No We were able to automatically migrate these categories to Amazon V2.
Automatic migration not possible Yes We can’t automatically transfer these categories for you. You’ll need to manually map these again in the Categories step.
No migration suggested by Amazon Yes Amazon couldn’t determine which categories to recommend for these items for Amazon V2. Map these fields manually or contact Amazon support for help.
Empty attributes Optional These attributes were left empty in your old API. 
  1. Click Migrate. This creates an inactive copy of your Amazon API for Amazon V2 titled: [Your Amazon API name] (Migration). 
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. 

 

Step 2: Map categories

  1. In your new migrated API, go to the Categories step. 
  2. Manually categorize any products that weren’t automatically migrated. 
  3. Click Save.

 

Step 3: Map attributes

  1. Navigate to the Build step. In the ‘Shared attributes’ tab, ensure all fields marked as required by the marketplace are mapped to the appropriate field from your data. 
    1. Fill in either the External product ID or Merchant Suggested ASIN fields, depending on your use case.
    2. If you don't want to send price data, ignore the Purchaseable offer field.
      Important: The Type value for your External product ID is case sensitive, and must be ean, gtin, or upc. If you have EAN, GTIN, or UPC, you'll need to create a rule to convert it to lowercase.
  2. Click Save. 
  3. Repeat this for the ‘Attributes per category’ tab.
    1. To find the Quantity (stock information) field, go to the Build step, click the Attributes per category tab and scroll to the Offer section. Next to Fulfillment availability, click the+ Add button.
      • If you are using MFN, set Fulfillment channel code field to DEFAULT (Click the dropdown field > Static values > DEFAULT). 
      • If you are using AFN, set Fulfillment channel code to the Amazon warehouse code (Click the dropdown field > Static values > [your relevant Amazon code]).  

    2. If you're selling on Amazon US and the Item Type Keyword attribute appears in the "Information to uniquely identify your product" section, click the field and select Internal fields > recommended_browse_nodes.

  4. Go to the Quality step. 
  5. Review and resolve any items flagged with errors.
Note: Amazon may request you to add additional fields that aren’t relevant for your products. You can ignore these mandatory fields.

Example: You sell clothes, but Amazon declares you need to indicate whether the product has a battery.

 

Step 4: Test your API

  1. Navigate to the Preview step and open the ‘Matched items’ tab.
  2. Click Dry run to check how your listings in Channable match the items in your Amazon account.
Note: Find out more about Dry runs.

 

Step 5: Activate your API and resolve errors 

To give you control over your listings, your original Amazon V1 API remains active until you choose to deactivate it. 

Important: If you have multiple scheduled runs per day, keeping both APIs active may cause performance issues and delays. To prevent this, deactivate your V1 API before activating your V2 API.
  1. When you’re ready to launch, return to the Settings step and click Activate API.
  2. Click Run now to send your product listings to Amazon. 
  3. Go to the Result step to check if any products have errors. Click on an error to get an error overview. From here, you can click Go to attribute to be redirected to map the relevant field to resolve it.
  4. On the Attributes page, click the ‘?’ tooltip to learn more about the accepted values, or click the field and select Static values to view a list of acceptable inputs.
  5. If you have multiple Amazon APIs, repeat the steps in this article for each API.

 

Step 6 (optional): Activate the Repricer 

This step is applicable if you use our repricer (add-on).

  1. In [your Amazon API], go to Rules and check the reprice rules that have been automatically migrated.
  2. Go to the Settings step and click Activate repricer.
  3. Click Save.

 

Step 7: Deactivate your old V1 API

At this point, you’ll have two activated APIs - your original Amazon API on V1, and your new API on V2.

We recommend deactivating your V1 API after you’ve resolved your errors in V2. This is because, while your product listings will remain active, running two active APIs simultaneously can slow their performance.

To deactivate your Amazon V1 API:

  1. In [your original Amazon API], go to the Settings step and click Deactivate API.