Create or fully update a listing

Learn how to create or fully update an Amazon listing for a given selling partner and Amazon marketplace.

Prerequisites

To complete this tutorial, you need:

• Authorization from the selling partner for whom you are making calls. Refer to Authorizing Selling Partner API Applications for more information.
• Approval for the Product Listing role in your developer profile.
• The Product Listing role selected in the App registration page for your application.
• A JSON-based listing payload adhering to the JSON Schema provided by the Selling Partner API for Product Type Definitions for the given selling partner, Amazon marketplace, and Amazon product type.

🚧

Warning

The putListingsItem operation creates a new listing or replaces the existing content of a listing. Existing attributes may be dropped if omitted from the putListingsItem submission. For example, if the listing previously contained bullet points and a putListingsItem submission is made with the LISTING_OFFER_ONLY requirements without including the bullet points, the putListingsItem submission will remove the bullet points content on existing listings.

Submit listings item put request

Call the putListingsItem operation to create or fully update a listing.