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 promotionSettingAction attribute to Create.
  • To update an existing promotion, set the promotionSettingAction attribute to Create with promoId.
  • To delete a promotional price, set the promotionSettingAction attribute to Delete.
  • To delete all promotions for a SKU, set the promotionSettingAction attribute to replaceAll.
The effective start date for a given promotion should be within 365 days from the current date and time. The end date of a given promotion should be within 180 days from the start date and time. Any promotions beyond 180 days will result in an error.

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_PROMOTION

Sample 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

  1. Replace SKU_Item in the request URL or parameters with the actual SKU of an item.
  2. Replace WM_SEC.ACCESS_TOKEN and WM_QOS.CORRELATION_ID with actual values.
  3. Update price to set a new selling price.
  4. Set the msrp or strikethrough price.
  5. Change the businessUnit if your product is listed in a different region.
  6. Change the version to 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.


Did this page help you?