Channable
Globe icon
English (US) Deutsch Español Français Italiano Nederlands
  1. Help Center - Channable
  2. Channels - Marketplaces
  3. Amazon Marketplace

Articles in this section

See more

How to migrate an Amazon channel (API) to Amazon V2

Amazon requires all users to update their API to its latest version (V2) by June 30, 2025. 

Follow the steps in this article to migrate your existing Amazon channel on V1 to the latest version.

 

What happens if I don’t migrate by June 30*?
  • 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 lost sales and ad spend on products without results.
Note: Migrating won’t disrupt your Amazon services, so your listings will stay active. After migrating you can make changes to your products through your migrated Amazon V2 channel. 
*This deadline is determined by Amazon and may change

 

Contents


Before you start

There are some things you should know before you start:

Good to know

  • If you have multiple Amazon channels, you'll need to repeat these steps for each channel.
  • If you have multiple Amazon channels with parent-child relationships, make sure you repeat these steps for each channel.

 

Step 1: Migrate your channel to V2

  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 channel 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 channel. 

Step 2: Map categories

Your actions in this step depend on whether your categories were automatically migrated in step 1.

I didn’t have any categories to migrate / none of my categories migrated

If you don’t have any categories after migrating, you’ll need to categorize your products again. 

  1. Open [your Amazon V2 channel] and go to the Result step. 
  2. In the Overview tab, click Start dry run now. This checks your product data without sending anything to Amazon. 
  3. After the dry run is complete, you’ll see a list of items. Click Download as CSV to download your product data.
  4. Open a new tab in your browser and go to Google sheets. Select Blank spreadsheet.
  5. Import your CSV file into the spreadsheet (Go to File > Import > [your CSV file]).
  6. Publish your Google spreadsheet to make it publicly available. (Go to File > Import and select [your downloaded CSV file]). Copy the generated link.
  7. Back in Channable, go to Setup > + Combine imports.
  8. Select Google spreadsheet and fill in the following:
    1. For Name, provide a descriptive name (e.g. “Amazon categories”)
    2. For Google spreadsheet URL, paste the URL you copied earlier.
  9. Click Start import to import the file.
  10. Click Edit mapping and map channable.client_id to id.
  11. For Merge options, select Combine on field and choose id.
  12. Return to [your Amazon V2 channel] and go to the Rules step.
  13. Create the following rule:

If amazonlisting_product_type isn’t empty

Then take category and copy value from amazon_listing_product_type

  1. Click Save. 

Most or all of my categories migrated 

  1. In [your Amazon V2 channel], go to the Categories step. 
  2. Check your categories and manually categorize any products that weren’t automatically migrated.
  3. Click Save.

Step 3: Map shared attributes

  1. Go 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 (indicated by )
  2. At Merchant Suggested ASIN, field, click the dropdown and map the field containing your product ASIN. If you don’t have a field containing your ASIN information, map External product ID instead.
  3. At External product ID, click + Add and map the following fields: 
    1. For Type, click the dropdown, select Static value and click on the ID format used to identify your products (e.g. ean, gtin, upc)
    2. For ID, click the dropdown and map the corresponding field in your import that contains your products ID data. 
  4. If you don't want to send price data, ignore the Purchasable offer field.
  5. Click Save. 
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.

Step 4: Map category attributes 

Select your use case:

I ship my products myself (MFN - Merchant Fulfilled Network)
Important: If you’re using our repricer (add-on), make sure you set the Fulfillment channel code to DEFAULT and map the Quantity field with your stock. 

If you don't map these correctly, the repricer receives incorrect data that prevents it from repricing affected items, which may lead to a decrease in won buy boxes.
  1. In the Build step, click on the Attributes per category tab, and scroll to the Offer section. 
  2. Next to Fulfillment availability, click the + Add button.
    1. For Fulfillment channel code, set the field to DEFAULT (Click the dropdown field > Static values > DEFAULT).  
    2. For Quantity, select your stock field.
  3. Map any remaining fields marked as required to an appropriate field.
    1. 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.
Amazon ships my products (AFN - Amazon Fulfilment Network / FBA - Fulfillment by Amazon)
Important: If you’re using our repricer (add-on), make sure you set the correct Amazon warehouse location for the Fulfillment channel code (e.g. AMAZON_EU). Do not map the Quantity field.

If you don't map these correctly, the repricer will receive incorrect data, preventing it from repricing affected items. This can lead to a decrease in won buy boxes.
  1. In the Build step, click on the ‘Attributes per category’ tab.
  2. Scroll to the Offer section. Next to Fulfillment availability, click the + Add button.
    1. 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.
  3. Go to the Quality step. 
  4. Review and resolve any items flagged with errors.
Tip: Click Auto-map fields to automatically map (match and fill) mandatory fields based on your import data.

Step 5: Test your channel

  1. Navigate to the Result step of [your Amazon V2 channel].
  2. Click Start dry run now. This checks how your product listings in Channable match the items in your Amazon account without sending data to Amazon. This helps you identify and fix possible issues before activating.
Tip: You can perform a dry run as many times as you need. Learn more.

Step 6: Deactivate your old V1 channel

Important: If you have multiple scheduled runs per day, keeping both channels active may cause performance issues and delays. To prevent this, deactivate your V1 channel before activating your V2 channel.
  1. In the sidebar, click Channels and select [your old Amazon API] (on V1).
  2. Go to the Settings step and click Deactivate API. 
  3. Click Save.

Step 7: Activate your V2 channel

Your original Amazon V1 channel remains active until you choose to deactivate it. 

  1. When you’re ready to launch, return to the Settings step and click Activate API.
  2. Click Save.
  3. Click X to return to the channel overview page.
  4. Click Run now to send your product listings to Amazon. 

Step 8: Review and fix listing errors

Important: You might see a lot of errors on this page. Don’t worry - we display all possible errors to help you meet Amazon’s listing requirements.
Amazon has strict data requirements for product listings. This step explains how to check if your listings are live and how to review and fix issues preventing them from listing.
  1. Go to the Result step of your Amazon channel and click on the Feedback tab. This page displays all issues your product data has at a given moment, including errors (actively need resolving) and warnings (recommended to review)
  2. Return to the Overview tab. This page is an overview of your products and their listing status. Click the All dropdown to filter by status:
    • Active listings: Products successfully listed on Amazon
    • Inactive listings: Products listed on Amazon, but not active
    • Incomplete listings: Products missing information required to get listed 
    • No match found: Products not found in Amazon’s catalog
  3. Return to the Feedback tab and begin resolving issues, starting with submission errors.
    Tip: Resolving submission errors before listing errors can prevent the error from affecting other listings.
    1. See what caused the error by clicking on the red error code (in Description).
    2. Note the attribute causing the error (e.g. ‘Item Weight’) and click Go to attribute. This redirects you to the attribute you need to fix (at the top of the page)
    3. Re-map the field(s) causing the issue by selecting a static field (if available), a field from your project data, or entering a custom value to be applied across all products (manual value).
    4. Click Save.
  4. Repeat these steps for other errors.
  5. Click Run now to resend your products to Amazon.

Amazon needs time to process and list your products. The time this takes varies, depending on the number of products you're sending. In most cases, your listings should be live within 3 to 5 hours.

To see which listings are live in the meantime, you can perform a Dry run at any time. For the best chance of getting your products live, resolve as many submission errors as possible before doing this, as Dry runs clear submission errors which can only be retrieved again in later normal runs.

Important: Some listing state errors are caused by the older versions of the Amazon API (V1). Currently, these errors can’t be resolved with standard use of the API on the latest version (V2). Amazon is aware of this issue and is working on a fix.

What you can do for now:

Delete listings with the error by removing their SKUs from your channel. Wait 24 hours, then resubmit the listing.

Step 9 (repricer users): Activate the Repricer 

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

  1. In [your Amazon channel], 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.