Migration FAQ

This FAQ covers questions that developers may encounter when migrating from Amazon Marketplace Web Service (MWS) to Selling Partner API (SP-API). Answers may vary depending on your application as well as whether the app is private or public.

General migration topics

When is Amazon MWS going away?

Select to expand the answer.

MWS will no longer be available for use after March 31, 2024. Amazon has chosen a phased deprecation for Amazon MWS, and we have publicly announced migration due dates for both third-party public app developers and private app developers.

Why is Amazon replacing MWS with SP-API?

Select to expand the answer.

SP-API offers all developers a number of improvements over Amazon MWS, such as modernized, JSON-based REST API design standards, OAuth2.0 selling partner authorization using Login with Amazon, and a test endpoint - the most requested feature in MWS. In addition to all legacy functionality previously provided in Amazon MWS and new API capabilities for sellers, SP-API supports the first ever APIs for Amazon vendors – all through the same API control plane and authorization mechanisms. Going forward all new API functionality will be built in SP-API, with updates to MWS only to support business critical changes until MWS is deprecated. Having all developers integrated with SP-API will provide the best experience for both Selling Partners and developers.

Where can I learn more about SP-API?

Select to expand the answer.

Refer to the Selling Partner API Developer Guide for more information about SP-API.

Is it mandatory to migrate from Amazon MWS to SP-API?

Private developers select to expand the answer.

Yes. Private MWS Developers who own Amazon MWS Developer ID and Access Keys and are using MWS Merchant Fulfillment, Orders, or Reports API sections must migrate these sections to SP-API by August 31, 2023 to prevent business disruption. Additionally, private MWS developers using all other MWS API sections must be fully migrated to SP-API by March 31, 2024.

Private developers who decide to not to integrate with SP-API can authorize a third-party application from the Amazon Selling Partner Appstore to replace their Amazon MWS private integration.

Public developers select to expand the answer.

Yes. The first phase of Amazon MWS deprecation began April 6, 2021, for Orders, Reports, and MFN sections for all public applications authorized by selling partners in the Marketplace Appstore. You must migrate by July 31, 2022 to prevent business disruption.

Additionally, all public applications authorized by Selling Partners, using the MWS Products API, must migrate to SP-API by September 30, 2022.

All public applications authorized by Selling Partners, using all other MWS API sections, must be fully migrated to SP-API by December 31, 2022.

What are private and public developers?

Select to expand the answer.

A private developer builds application(s) that integrate their own company with Amazon APIs.

A public developer builds and offers publicly available applications that are used by other companies.

What are private and public applications?

Select to expand the answer.

A private application is available only to your organization and is self-authorized.

A public application is a publicly available application that is used by other companies.

How do I know if I am a private MWS developer or if I have access to MWS?

Select to expand the answer.

If you use MWS to support your business automation needs, you are a private developer with an MWS Developer ID and MWS Keys assigned to your account. Use the following process to view your credentials:

Log in to your Amazon selling account on Seller Central as the primary account holder. Choose Settings and then choose User Permissions.
Choose Amazon MWS Developer Access Keys and then choose Visit Developer Credentials.
On the Developer Central page, choose MWS credentials and then choose View.

What is the Amazon Selling Partner Appstore?

Select to expand the answer.

The Amazon Selling Partner Appstore is a one-stop shop where sellers can discover trusted apps to help grow and manage your business. The Selling Partner Appstore connects sellers with Amazon approved third party software partners who can help you start and grow your business online from automated pricing to listing tools. Many apps focus on automating previously time-consuming and tedious daily tasks like product research, filling out tax forms, or building customized reports.

I'm a private developer for a private vendor app, do I need to migrate?

Select to expand the answer.

Vendors were on-boarded directly to SP-API. There is no need to migrate unless you have access to MWS for a different use case.

What migration due dates apply to my private application?

Private developers select to expand the answer.

If you have a private Amazon MWS Developer ID and Access Keys that call the Merchant Fulfillment (MFN), Orders, or Reports API sections, then you must create and operate a private Selling Partner app to integrate these sections. This must be completed by August 31, 2023.

Note: If you have a hybrid or SP-API based private application that requires restricted data, you must update your application to use a Restricted Data Token (RDT) via the Tokens API by August 31, 2023. You can view a list of affected operations here.

If you have a private Amazon MWS Developer ID and Access Keys that use any other MWS API sections, then you must create and operate a private Selling Partner app that is integrated with SP-API by March 31, 2024. This includes applications using the following MWS API sections:

* Feeds API
* Finances API
* Fulfillment Inbound Shipment API
* Fulfillment Inventory API
* Fulfillment Outbound Shipment API
* Products API
* Recommendations API
* Sellers API
* Subscriptions API
* Push Notifications Schemas

Private developers who decide not to integrate with SP-API can authorize a third-party application from the Amazon Selling Partner Appstore to replace their Amazon MWS private integration.

Note: In 2022, we are focusing migration efforts on third-party public applications that are authorized by Amazon Selling Partners that may also be listed in the Amazon Selling Partner Appstore. More information about third-party migration can be found in this announcement.

Public developers select to expand the answer.

In 2022, we are focusing migration efforts on third-party public applications that are authorized by Amazon Selling Partners that may also be listed in the Amazon Selling Partner Appstore. We will send direct communication via email and Seller Central cases to all public MWS developers affected by this, which will help confirm the actions your organization must take. Below are the conditions that apply to public MWS developers who will need to migrate to SP-API:

If you have an Amazon MWS-based public application that uses the Merchant Fulfillment Network (MFN), Orders, or Reports API, you must update your application to integrate these sections to SP-API by July 31, 2022.
If you have a hybrid or SP-API based public application that requires restricted data, you must update your application to use a Restricted Data Token (RDT) via the Tokens API by July 31, 2022. You can view a list of affected operations.
If you have an Amazon MWS-based public application that uses the Products API, you must update your application to integrate with Catalog Items and Listings Items in SP-API by September 30, 2022.
If you have an Amazon MWS-based public application that uses any other MWS API section, you must update your application to be fully integrated with SP-API by December 31, 2022. This includes applications using the following MWS API sections:
- Feeds API
- Finances API
- Fulfillment Inbound Shipment API
- Fulfillment Inventory API
- Fulfillment Outbound Shipment API
- Recommendations API
- Sellers API
- Subscriptions API
- Push Notifications Schemas

Private MWS Developers: For information about private developer migration, refer to Amazon Marketplace Web Service (MWS) end-of-life dates

What does "support for Amazon MWS Orders, Reports, and Merchant Fulfillment Network (MFN) sections will be discontinued" mean?

Private developers select to expand the answer.

Discontinuing support means that API calls from private Amazon MWS Developer ID and Access Keys that use the specified sections of Amazon MWS, will not be successful after August 31, 2023.

Calls to all other Amazon MWS sections (operations and paths) will continue to be successful on and after August 31, 2023, as they are today.

Public developers select to expand the answer.

Discontinuing support means that API calls from public applications using the specified sections of Amazon MWS will not be successful after July 31, 2022.

Calls to all other Amazon MWS sections (operations and paths) will continue to be successful on and after July 31, 2022, as they are today.

I'm a Selling Partner with a private Amazon MWS application who wants to find a third party app to authorize instead of migrating. How do I find the right app for my business?

Select to expand the answer.

Visit the Amazon Selling Partner Appstore and type in keywords to search for applications based on name or supported functionality. You can also refine your search by languages supported, Marketplaces supported, pricing type, and other search filters. On the homepage, you can also see a list of categories to explore in addition to personalized app recommendations.

An external developer company built our existing MWS app, but they are no longer available, and I do not have experience developing applications. What should I do?

Select to expand the answer.

If you have access to the original code files of your application, you can contract another external developer company to help you migrate your MWS app to SP-API, or request that they help create a new app with SP-API.

Additionally, you have the option to find a third-party app solution to replace your private Amazon MWS integration. You must take action before the posted due dates, based on your MWS API usage, to avoid business disruption. We encourage you to visit the Amazon Selling Partner Appstore, to review over 2,000 vetted apps that offer various automation solutions for your business needs.

If I start the migration process, will there be any interruptions to the daily workflow supported by my app?

Select to expand the answer.

Your app will continue to work with MWS as usual during migration. We will not remove MWS access from your account until the posted due dates, or until you confirm you have completed the necessary actions to migrate/replace your MWS app functionality (whichever comes first).

Access to MWS Merchant Fulfillment Network (MFN), Orders, and Reports API selections will be unavailable for all private developers after August 31, 2023.

All other MWS API sections will be unavailable for all apps after March 31, 2024.

The process to migrate to SP-API seems too complicated for me to complete. If I am unable to migrate, or do not want to migrate, what options do I have?

Select to expand the answer.

If you decide not to create and own a private Selling Partner app, or do not want to migrate to SP-API, you also have the option to find a third-party app solution to replace your current business automation services. We encourage you to visit the Amazon Selling Partner Appstore, to review over 2,000 vetted apps that offer various automation solutions for your business needs.

One other option you can take is to search online for external companies that offer contracted developer services to help you migrate your app from MWS to SP-API, or create a new private SP-API app.

Apps are listed in my Manage your apps section. What action do I need to take?

Select to expand the answer.

The applications shown in this section are third-party public applications that you have authorized to access your selling information to support your business automation needs. These apps are owned and developed by third-party public developers who are responsible for migrating the app to SP-API. As a user of the app, do not need to take action for these apps.

I use MWS to access apps such as Listing Loader or Amazon Merchant Transport Utility (AMTU), do I need to migrate?

Select to expand the answer.

AMTU/Listing Loader will maintain access to MWS for all functionality until August 31, 2023. After this date, the AMTU tool will be deprecated. More information will be posted on the AMTU Help Page as it becomes available.

Note: Important Information for AMTU users submitting Automotive Aftermarket Catalog Exchange Standard (ACES) fitment feeds:
Automotive selling partners and third party data providers who submit fitment data through AMTU need to migrate to a new tool for ACES feed submission on or before 04/01/2023. Please follow the instructions on the Providing and adding fitment data page.

Are Amazon Pay developers affected by migration?

Select to expand the answer.

Amazon Pay developers who are using MWS will be affected by the MWS end-of-life date: March 31, 2024. Further details about what actions Amazon Pay developers must take will be shared in separate communications later this year.

Account and access topics

I’m a public developer that replied to the email from `[email protected]` and confirmed that my migration to SP-API is complete. What happens next?

Select to expand the answer.

If you have a hybrid (MWS/SP-API) application:

We will convert your hybrid SP-API app to a SP-API only app. Note: Your app must be in Published status.
We will block your ability to accept new seller MWS authorizations after your app is converted to SP-API only. Note: This action will not be taken if your app type is still hybrid.
We will remove your access to all MWS API sections.

Note: Alternatively, you can use the Convert a Public Amazon MWS Application into a Selling Partner API Application tutorial to convert your application from hybrid to SP-API. Please allow up to 15 business days for this change to publish.

If you have a MWS application:

We will block your ability to accept new seller MWS authorizations.
We will remove your access to all MWS API sections.

We’ll notify you 2 days before we take make any modifications to your MWS access, and you'll receive a confirmation message when changes are complete.

My Seller Account has been deactivated. How can I proceed with migration?

Select to expand the answer.

Please contact Selling Partner Support to request your account be re-activated at Get Support.

How do I apply for SP-API access or update the SP-API roles I have access to?

Private developers select to expand the answer.

If you already have access to MWS, you do not need to apply for access in SP-API, unless you want access to new roles in SP-API.

All existing MWS developers, with active MWS keys and assigned access roles in MWS, already have access to the equivalent roles in SP-API, allowing you to get started with your migration.

If you want to add new SP-API roles to your account, you can submit an update to your SP-API Developer profile anytime by visiting the Seller Central URLs page and then choosing the URL for your region. Choose Appstore, then Develop Apps, View Profile, and finally choose Register to add roles to your account.

You can also learn more about SP-API roles and find more information to get started with your integration through video guides in Seller University.

Public developers select to expand the answer.

Submit or update your Developer Profile at the developer registration page.

You can also learn more about SP-API roles and find more information to get started with your integration through video guides in Seller University.

I am not able to see the Edit app, Develop apps, or Register app options in my Seller Central account and therefore cannot select them. What should I do?

Select to expand the answer.

Ensure the Seller Central account you are logged into is the account your MWS/SP-API application is associated with. This should be the account to which your organization submitted your developer registration and assessment gorm/developer profile details.

You should also be logged in as the primary user of the account. Secondary users of the account may not have the same permissions as determined by the primary user.

You must also confirm your account is currently a Professional Selling Account. Only Professional Selling Accounts can register to develop or integrate with MWS or SP-API. Individual level accounts are not eligible. Navigate to your account information page and select Your Services in Account info to view your selling plan type and the marketplace information.

I'm unable to move forward in my migration because my Developer Profile case or Amazon Selling Partner Appstore listing case is still pending review.

Select to expand the answer.

Depending on the information you submitted in your Developer Profile, it may take our Developer Support teams several days to respond after completing the evaluation. Continue to monitor the case for updates.

Note for public developers: if you recently submitted a new Selling Partner Appstore Listing, you may not be able to make additional updates until the details have been reviewed by our Developer Support team and published.

I'm aware that I need to set up an AWS account, but do I need to pay for this account?

Select to expand the answer.

The AWS Identity and Access Management (IAM) service has no cost associated to it. AWS account setup requires you to enter a payment method, however you will not incur any cost by using IAM. If you are going to use any other AWS resources however, those will incur a charge per AWS pricing.

I'm trying to update my Amazon Selling Partner Appstore Listing, but my app is showing as Suppressed. Can it be reactivated?

Select to expand the answer.

You may edit an app that is in Suppressed status by selecting Edit app from the drop-down menu. Once you submit your updates, your app listing status will change to Edit pending review.

I'm a Selling Partner, my private Amazon MWS application is used only by my organization, and want to integrate with SP-API. How do I do this?

Select to expand the answer.

All existing MWS developers with active MWS keys already have access to the equivalent roles in SP-API which allows you to start migration. The steps for a private application to integrate with SP-API are provided in the tutorial Create a private Amazon MWS application into a Selling Partner API application.

As a private developer, how do I authorize a third-party app?

Select to expand the answer.

The Amazon Selling Partner Appstore, is available without logging in, allowing prospective sellers to discover solutions. Current Amazon sellers will also be able to find the Amazon Selling Partner Appstore in the top menu of the Seller Central navigation bar and will be directed to the store by selecting Find Apps.

Visit the Amazon Selling Partner Appstore and enter in keywords to search for applications based on their name or supported functionality. You can also refine your search by Average Customer Review ratings, languages supported, Marketplaces supported, pricing type, and other filters. On the Selling Partner Appstore home page, you can also see a list of categories to explore in addition to recommended apps your business may find useful.

You can select the detail pages for these app to further learn about the features and descriptions of the app services provided.

Once you find an app that works for your business, choose Authorize Now on the top right corner of the app detail page. You are directed to a confirmation page you must submit to allow the third-party app access to your Selling Partner account and related data for your business automation needs.

You may de-authorize an app at any time in the Manage your apps page of your Seller Central account.

As a private developer, do I have a Developer ID and Access Keys in SP-API?

Select to expand the answer.

The MWS Developer ID and MWS Access Keys you were assigned in MWS do not apply in SP-API. When you migrate, you will register a new private Selling Partner application to receive your new application client ID and secret.

Refer to Viewing your application information and credentials for more information.

I'm a public developer who received an email about migration requirements from the email address “[email protected]” but am not able to reply to this email alias. What do I do?

Select to expand the answer.

Note that the email alias [email protected] does not accept incoming emails. You can reply to the message through the case in your Seller Central account that is associated with your MWS application.

To access your case log, sign into the Seller Central account that is associated with your Amazon MWS Access Keys. On the Seller Central gateway page, at the Manage Your Case Log widget, select View your case log. Note that you must be the primary account holder to view this page.

For more information, see the Seller Central Case Log Guide.

I'm a public developer and was informed that I may have received a message about migration requirements in my Seller Central account. How can I access my support case log?

Select to expand the answer.

For more information, see the Seller Central Case Log Guide.

Based on the 2023 Migration due dates, when will my MWS account lose access to data?

Select to expand the answer.

If your application is actively retrieving data from the MWS Merchant Fulfillment, Orders, and Reports API sections, you will continue to have access to these sections through August 31, 2023. After this date, you will receive a notice informing you about when your account will officially lose access to retrieve data from these three sections. After this date, we will send a notice informing you about when your account will officially be blocked from retrieving data from these three sections.

If you submitted a Migration Plan Form, we will not block access to MWS without further confirmation from you.

Your access will only be removed before the August 31, 2023 migration due date in the following scenarios:
• You have confirmed that you have completed migration and/or confirmed your app no longer requires access to the Merchant Fulfillment, Orders, and Reports API sections sections.
• You have not actively retrieved data from the Merchant Fulfillment, Orders, or Reports API sections for over 90 days. As a reminder, you should only retrieve information that is necessary for your app's functionality. You may refer to our Acceptable Use Policy for more information.

In all scenarios we will send a notice, a minimum of 14 days ahead of time, about changes to the Seller Central account that is associated with your MWS credentials.

Migration technical support topics

Refer to SP-API General Frequently Asked Questions for a list of General SP-API FAQs and troubleshooting solutions.

I'm having trouble configuring my IAM resources. Is there a programmatic way to do this?

Select to expand the answer

The Selling Partner API on AWS Quick Start configures an AWS Identity and Access Management (IAM) role to streamline your SP-API onboarding. In addition, it provides a sample AWS Lambda function to demonstrate AWS best practices for SP-API integration. After deployment, use the sample function to test connectivity to SP-API endpoints.

I need help on one of the steps listed in the Migration Guide, what other resources are available to me?

Select to expand the answer.

We launched several videos in Seller University that provide further guidance on the migration steps listed in the Migration Guide.

I'm a private developer and need to connect to my app from accounts in different regions. How can I do this without a Developer ID?

Select to expand the answer.

If you have selling accounts in multiple regions, with SP-API, you only need to register one account that will able to access data across multiple regions to support all of your selling accounts.

For the accounts your company has in other regions, you can authorize the created app without the need of connecting with Developers ID (which are no longer used by SP-API), using the Seller Central authorization workflow. Refer to Registering your Application for more information.

I'm receiving an error code, how do I proceed?

Select to expand the answer.

Review the SP-API Errors FAQs page for a list of common error codes and troubleshooting solutions.

Can I create a test application in SP-API?

Select to expand the answer.

Yes, you can create a secondary application and can designate it as sandbox or test app. Refer to Selling Parter API sandbox for more information.

I'm a private developer, how do I create a new application for SP-API?

Private developers select to expand the answer.

Refer to the Tutorial: Create a private Selling Partner API application

Public developers select to expand the answer.

Refer to the Tutorial: Convert a public MWS application into a Selling Partner application

If I switch my public MWS app to a hybrid SP-API application, which uses both Amazon MWS and SP API, will my app continue making MWS calls?

Select to expand the answer.

Yes, Amazon MWS operations will continue to work with a hybrid app. After you publish your hybrid app, MWS calls and authorizations continue to function; however, the authorization workflow changes to an OAuth authorization workflow that the selling partner initiates from the Amazon Selling Partner Appstore. Existing Amazon MWS authorizations can be migrated to SP-API using the Selling Partner API for Authorization only after the hybrid app is published. More information is available in the Authorization API Use Case Guide.

Can I use the models reports_2021-06-30 or feeds_2021-06-30 for my migration? Are the new versions of Reports API or Feeds API available in production?

Select to expand the answer.

The reports_2021-06-30 and the feeds_2021-06-30 APIs are available to use in applications.

Refer to the Reports API Reference v2021-06-30/Reports API Use Case Guide v2021-06-30 or the Feeds API Reference v2021-06-30/Feeds API Use Case Guide v2021-06-30 for more information.

Are Migration documents in GitHub available in other languages?

Select to expand the answer.

For public developers, we currently have various translations available for migration documents in different languages, including:

German
Chinese
Japanese
French
Italian
Spanish
Portuguese
Turkish
Dutch

These documents are posted in GitHub.

Are there any additional resources available for Chinese developers?

Select to expand the answer.

Yes! From now through December 31, 2022, Amazon Web Services China will provide free one-to-one consultation for customers who speak Chinese and are interested in migrating their app integration to SP-API. Our technical experts will help tailor a migration solution suitable for your business development.

You can also get a $200 credit once you sign up for an Amazon Web Services account.

To request support from Amazon Web Services China, visit the SP-API migration solution website and fill out the contact form.

For more information, you can call the Amazon Web Services China support team at: +86-1010-0866.

Migration resources

Contact us

Contact: Selling Partner API Developer Support
Contact URL: https://sellercentral.amazon.com/gp/mws/contactus.html

📘
Didn't help?
If you didn't see your question or the answer didn't resolve the issue you're encountering, open a Support Case and we'll help you troubleshoot.

General migration topics

When is Amazon MWS going away?

Why is Amazon replacing MWS with SP-API?

Where can I learn more about SP-API?

Is it mandatory to migrate from Amazon MWS to SP-API?

What are private and public developers?

What are private and public applications?

How do I know if I am a private MWS developer or if I have access to MWS?

What is the Amazon Selling Partner Appstore?

I'm a private developer for a private vendor app, do I need to migrate?

What migration due dates apply to my private application?

What does "support for Amazon MWS Orders, Reports, and Merchant Fulfillment Network (MFN) sections will be discontinued" mean?

I'm a Selling Partner with a private Amazon MWS application who wants to find a third party app to authorize instead of migrating. How do I find the right app for my business?

An external developer company built our existing MWS app, but they are no longer available, and I do not have experience developing applications. What should I do?

If I start the migration process, will there be any interruptions to the daily workflow supported by my app?

The process to migrate to SP-API seems too complicated for me to complete. If I am unable to migrate, or do not want to migrate, what options do I have?

Apps are listed in my Manage your apps section. What action do I need to take?

I use MWS to access apps such as Listing Loader or Amazon Merchant Transport Utility (AMTU), do I need to migrate?

Are Amazon Pay developers affected by migration?

Account and access topics

I’m a public developer that replied to the email from [email protected] and confirmed that my migration to SP-API is complete. What happens next?

My Seller Account has been deactivated. How can I proceed with migration?

How do I apply for SP-API access or update the SP-API roles I have access to?

I am not able to see the Edit app, Develop apps, or Register app options in my Seller Central account and therefore cannot select them. What should I do?

I'm unable to move forward in my migration because my Developer Profile case or Amazon Selling Partner Appstore listing case is still pending review.

I'm aware that I need to set up an AWS account, but do I need to pay for this account?

I'm trying to update my Amazon Selling Partner Appstore Listing, but my app is showing as Suppressed. Can it be reactivated?

I'm a Selling Partner, my private Amazon MWS application is used only by my organization, and want to integrate with SP-API. How do I do this?

As a private developer, how do I authorize a third-party app?

As a private developer, do I have a Developer ID and Access Keys in SP-API?

I'm a public developer who received an email about migration requirements from the email address “[email protected]” but am not able to reply to this email alias. What do I do?

I'm a public developer and was informed that I may have received a message about migration requirements in my Seller Central account. How can I access my support case log?

Based on the 2023 Migration due dates, when will my MWS account lose access to data?

Migration technical support topics

I'm having trouble configuring my IAM resources. Is there a programmatic way to do this?

I need help on one of the steps listed in the Migration Guide, what other resources are available to me?

I'm a private developer and need to connect to my app from accounts in different regions. How can I do this without a Developer ID?

I'm receiving an error code, how do I proceed?

Can I create a test application in SP-API?

I'm a private developer, how do I create a new application for SP-API?

If I switch my public MWS app to a hybrid SP-API application, which uses both Amazon MWS and SP API, will my app continue making MWS calls?

Can I use the models reports_2021-06-30 or feeds_2021-06-30 for my migration? Are the new versions of Reports API or Feeds API available in production?

Are Migration documents in GitHub available in other languages?

Are there any additional resources available for Chinese developers?

Migration resources

Contact us

📘Didn't help?

I’m a public developer that replied to the email from `[email protected]` and confirmed that my migration to SP-API is complete. What happens next?

📘
Didn't help?