API Recipes

New Item Onboarding and Go-Live

This recipe was an interactive walkthrough in the previous portal. Each step below names the API call it makes; open it in the API Reference to try it.

Overview

Step 1: Search Catalog

Search the Walmart Marketplace catalog by keyword before creating a new item — if a matching item

API call: searchCatalogItems

Example arguments:

{
            query: {
              keywords: "wireless mouse",
              marketplaceIds: ["WALMART_US"],
            },
          }

Step 2: Submit Item Setup Feed

Upload a feed file to create the new item. Select ITEM_SETUP_FEED as the feed type (pre-filled

API call: createFeed

Example arguments:

{
            query: { feedType: "ITEM_SETUP_FEED" },
          }

Step 3: Poll Feed Status

Check the feed's processing status. processingStatus moves from RECEIVED to IN_PROGRESS to

API call: getFeed

Example arguments:

{
            path: { feedId },
          }

Step 4: Get Listing Details

Once the feed shows DONE, look up the listing by seller ID and SKU to confirm it is live and

API call: getListingsItem

Example arguments:

{
            query: { marketplaceIds: ["WALMART_US"] },
          }

Step 5: Set Inventory

Set the sellable inventory quantity for the new item's SKU so it can start receiving orders.

API call: updateInventoryForSku

Example arguments:

{
            path: { sku },
            body: {
              quantity: 100,
            },
          }

Step 6: Submit Pricing Feed

Upload a feed file to set the item's price. Select PRICING_FEED as the feed type (pre-filled

API call: createFeed

Example arguments:

{
            query: { feedType: "PRICING_FEED" },
          }

On this page