Guides
My Account

Create a new seller-fulfilled item (Full item setup)

Full item setup refers to the initial setup and publishing of items to the Walmart catalog. Use the bulk item setup API with feedType=MP_ITEM to create new seller-fulfilled items in bulk.

Typically, sellers can create or update 10,000 items at once. However, the 10K item limit can vary depending on individual seller agreements and may be limited to 5,000 for some sellers.

Before you start

If you haven’t already confirmed whether the item exists in Walmart’s catalog, start with the item search API.

If the item already exists in Walmart’s catalog, consider create an offer for an existing Walmart item instead of full setup.

For endpoint details, feed submission requirements, and processing information, refer to the Bulk Item Setup API guide.

Use cases

  • Create new items in bulk so they can be included in the Walmart catalog.
  • Publish large assortments using a standard feed-based workflow, reducing manual item setup effort.
  • Submit multiple items in a single feed file for efficient catalog onboarding at scale.
  • Monitor feed-level and item-level processing results to validate new item setup submissions.
  • Identify and correct item-level errors, then resubmit only the affected items instead of reprocessing the entire catalog.
  • Support repeatable item setup and publishing workflows using a standardized feed submission process.

Reference guide

This guide explains how to submit an MP_ITEMfeed using the Bulk Item Setup API to create new items that will be included in the Walmart catalog.

For full technical details, including endpoints, parameters, and brief descriptions, refer to the Bulk Item Setup API Reference.

Endpoint

POST https://marketplace.walmartapis.com/v3/feeds?feedType=MP_ITEM


Query parameter

  • feedType (string): Use MP_ITEM for new item setup.

Request body

  • multipart/form-data with required file field (binary)

Request sample

curl --request POST \ --url 'https://marketplace.walmartapis.com/v3/feeds?feedType=MP_ITEM' \ --header 'WM_CONSUMER.CHANNEL.TYPE: <consumer-channel-type>' \ --header 'WM_GLOBAL_VERSION: 3.1' \ --header 'WM_MARKET: us' \ --header 'WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6' \ --header 'WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....' \ --header 'WM_SVC.NAME: Walmart Service Name' \ --header 'accept: application/json' \ --form 'file=@mp_item.json'
import requests url = "https://marketplace.walmartapis.com/v3/feeds"
params = {"feedType": "MP_ITEM"} headers = { "WM_CONSUMER.CHANNEL.TYPE": "<consumer-channel-type>", # optional "WM_GLOBAL_VERSION": "3.1", "WM_MARKET": "us", "WM_QOS.CORRELATION_ID": "b3261d2d-028a-4ef7-8602-633c23200af6", "WM_SEC.ACCESS_TOKEN": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....", "WM_SVC.NAME": "Walmart Service Name", "accept": "application/json",
} with open("mp_item.json", "rb") as f: files = {"file": ("mp_item.json", f)} resp = requests.post(url, headers=headers, params=params, files=files, timeout=60) print(resp.status_code)
print(resp.text)

Example payload 

{ "MPItemFeedHeader": { "sellingChannel": "marketplace", "feedType": "MP_ITEM", "processMode": "REPLACE", "locale": "en", "version": "5.0", "subset": "EXTERNAL", "subCategory": "product_content_and_site_exp" }, "MPItem": [ { "Orderable": { "productIdentifiers": { "productIdType": "GTIN", "productId": "06146190200012" }, "sku": "TRVAL28726", "specProductType": "Cooking Aprons", "price": 1, "ShippingWeight": 1 }, "Visible": { "Cooking Aprons": { "accessoriesIncluded": [ "Oven Mitt Set", "Chef's Hat" ], "shortDescription": "Lavish Home Silicone Oven Mitts are comfortable, durable and designed to provide maximum protection for your safety. The extra-long styling plus the quilted cotton lining provide extra protection for your hands, wrists and forearms. We have added a textured grip surface to both sides of our mitts so that either glove will fit your left or right hand.", "productName": "Cotton 2-Pocket Black Adjustable Neck Strap Vintage Chef Apron with Chef's Hat", "features": [ "Washable", "Stain-Resistant" ], "keyFeatures": [ "HEAT RESISTANT UP TO 480 DEGREES - Whether removing a pan from your oven, picking up a steaming pot from your stove or tending to a hot grill, you can rest assured that your hands and forearms will be well protected by these high quality, heat-resistant oven mitts", "SILICONE STRIPING PROVIDES A NON-SLIP GRIP - Our oven mitt has special silicone striping that provides a gripping material so you no longer have to worry about that bowl of hot food slipping or dropping when taking it out the microwave", "GREAT DESIGN AND HIGH QUALITY - 12.5 inch length protects wrists and forearms; all oven mitts and pot holders combination of silicone and cotton for maximum flexibility and maximum heat protection; soft and super comfortable terry cloth interior", "Package includes: 1 pair of heat and burn resistant oven mitts with terry cloth interior" ], "brand": "Saukore", "mainImageUrl": "https://i5-qa.walmartimages.com/asr/9e9d04d1-6520-448e-b336-f40b7fb98707.c4c99539377709c2a9e332558177be8b.jpeg", "productSecondaryImageURL": [ "https://i5-qa.walmartimages.com/asr/9e9d04d1-6520-448e-b336-f40b7fb98707.c4c99539377709c2a9e332558177be8b.jpeg", "https://i5-qa.walmartimages.com/asr/9e9d04d1-6520-448e-b336-f40b7fb98707.c4c99539377709c2a9e332558177be8b.jpeg", "https://i5-qa.walmartimages.com/asr/9e9d04d1-6520-448e-b336-f40b7fb98707.c4c99539377709c2a9e332558177be8b.jpeg" ], "isProp65WarningRequired": "No", "ageGroup": [ "Adult", "Teen" ], "assembledProductLength": { "measure": 1, "unit": "in" }, "assembledProductHeight": { "measure": 1, "unit": "in" }, "color": "Blue", "condition": "New", "assembledProductWeight": { "measure": 1, "unit": "lb" }, "has_written_warranty": "No", "assembledProductWidth": { "measure": 1, "unit": "in" }, "netContent": { "productNetContentMeasure": 1, "productNetContentUnit": "Each" }, "recommendedUses": [ "Residential", "Commercial" ], "smallPartsWarnings": [ "0 - No warning applicable" ], "state_chemical_disclosure": "None" } } } ]
}

Modify your code

  1. Prepare your feed file

    • Build the MP_ITEM feed file using the correct schema version required for your integration.

  2. Submit the feed
    Send your item feed by calling the bulk item setup API and submitting an MP_ITEM feed file or payload. The API returns a feedId.
    Use the feedId to monitor ingestion and processing.

  3. Monitor feed processing
    Monitor the status of the feed and the items submitted in the feed. When the feed status is PROCESSED, processing is complete and each item has either:

    • been successfully submitted, or

    • returned submission errors.

    Not all items submitted at the same time finish processing at the same time. Some items may complete while others continue processing.

  4. Fix errors and retry failed items
    If you receive errors for individual items, review the error details, validate your feed against the schema, and correct the payload. Re-submit only failed items when possible.
    If errors persist after correcting the feed, contact Partner Support.

  5. Confirm the item is in the Walmart catalog
    Once processing completes successfully, your item is included in the Walmart catalog.

Results

After a successful call (200):

  • You receive a feedId to track processing and item-level outcomes.
  • Once processing completes (feed status PROCESSED), items are either successfully submitted or returned with submission errors.
  • When submission is complete and processed, the item is included in Walmart’s catalog.

Next steps

  • Log WM_QOS.CORRELATION_ID per request for traceability.
  • Bulk Item Setup API — Review feed submission formats, limits, and processing details.
  • Update existing items — Learn how to update existing catalog items using bulk maintenance feeds.