Update promotional pricing for multiple items (bulk)
Call this endpoint to update promotional pricing in bulk for multiple items. You can modify the promotional pricing of multiple products in one request. This is useful for implementing promotional strategies across your catalog, such as seasonal discounts, competitive pricing adjustments, or clearance sales.
- To add a new promotion, set the
promotionSettingActionattribute toCreate. - To update an existing promotion, set the
promotionSettingActionattribute toCreatewithpromoId. - To delete a promotional price, set the
promotionSettingActionattribute toDelete. - To delete all promotions for a SKU, set the
promotionSettingActionattribute toreplaceAll.
Note: This page describes examples using only the required parameters and inputs to update promotional pricing for multiple items (bulk). For a full list of customization options and additional capabilities, refer to the Marketplace Promotions API Reference.
Endpoint
POST https://marketplace.walmartapis.com/v3/feeds?feedType=PRICE_AND_PROMOTIONSample request
This sample shows how to update promotional pricing details for multiple items in a single request. This API endpoint accepts a feed containing the updated promotion information for items identified by their SKUs.
curl --request POST \ --url 'https://marketplace.walmartapis.com/v3/feeds?feedType=PRICE_AND_PROMOTION' \ --header 'WM_GLOBAL_VERSION: 3.1' \ --header 'WM_QOS.CORRELATION_ID: Correlation_ID' \ --header 'WM_SEC.ACCESS_TOKEN: Access_Token' \ --header 'WM_MARKET: us' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "MPItemFeedHeader": { "businessUnit": "WALMART_US", "version": "2.0.20240126-12_25_52-api", "locale": "en" }, "MPItem": [ { "Promo&Discount": { "sku": "SKU00638931255307", "price": 11, "msrp": 15, "promoid": "28cc0144-5d70-4acb-b366-98a07c3ac671", "promotionInformation": { "promotionSettingAction": "Create", "promotionPlacement": "MAP Cart", "promotionType": "Clearance", "promotionPrice": 8.5, "promotionPriceStartDateTime": "2024-10-01T20:52:46Z", "promotionPriceEndDateTime": "2024-10-22T20:52:46Z" } } } ]
}
'import requests url = "https://marketplace.walmartapis.com/v3/feeds"
params = {"feedType": "PRICE_AND_PROMOTION"}
headers = { "WM_GLOBAL_VERSION": "3.1", "WM_QOS.CORRELATION_ID": "Correlation_ID", "WM_SEC.ACCESS_TOKEN": "Access_Token", "WM_MARKET": "us", "Content-Type": "application/json", "Accept": "application/json",
} body = { "MPItemFeedHeader": { "businessUnit": "WALMART_US", "version": "2.0.20240126-12_25_52-api", "locale": "en" }, "MPItem": [ { "Promo&Discount": { "sku": "SKU00638931255307", "price": 11, "msrp": 15, "promoid": "28cc0144-5d70-4acb-b366-98a07c3ac671", "promotionInformation": { "promotionSettingAction": "Create", "promotionPlacement": "MAP Cart", "promotionType": "Clearance", "promotionPrice": 8.5, "promotionPriceStartDateTime": "2024-10-01T20:52:46Z", "promotionPriceEndDateTime": "2024-10-22T20:52:46Z" } } } ]
} response = requests.post(url, headers=headers, params=params, json=body, timeout=30)
response.raise_for_status()
print(response.json())Modify your code
- Replace
SKU_Itemin the request URL or parameters with the actual SKU of an item. - Replace
WM_SEC.ACCESS_TOKENandWM_QOS.CORRELATION_IDwith actual values. - Update
priceto set a new selling price. - Set the
msrpor strikethrough price. - Change the
businessUnitif your product is listed in a different region. - Change the
versionto the feed version as specified by Walmart for a specific item.
Sample response
The sample response shows the unique ID for the feed submission, which you can use later to check the status of the bulk price update progress.
{ "feedId": "14066B6642344B76A8B77AC094F8C63B@AVMBAgA"
}Result
If successful, the API response returns a feedID.
You can use this feed ID with the Feed Status API or All Feed Statuses API to monitor the progress of your submission and display the line-item status.
Updated 7 months ago

