Docs

Bulk Update Promotional Price

Create, update, or delete promotional prices for multiple SKUs.

PUT

Query

Field selectionChoose which fields should be included in the response. Learn more
string

Comma-separated response fields to include.

Body

Arguments
string

The action to apply to promotions for this SKU.

string

**required** The market specific locale. Allowed values by market include: - `en` for US - `es` for MX & CL - `en` & `fr` for CA. - Market availability: Global

array of object
string

**required** The seller-defined Stock Keeping Unit (SKU) for the item being updated.

number

The promotional price for the item during the promotion window.

number

**required** The current selling price of the item on Walmart.com.

string

**required** The feed schema version. The values vary by region. Allowed values: - `2.0.20240126-12_25_52-api` for U.S. - `5.0.20250328-17_43_36-api` for CA, MX and CL. __Market availability: Global__

string

Business unit identifier matching the target market. For example, use WALMART_US for the US market. __Market availability: US__

number

The manufacturer's suggested retail price (MSRP) for the item.

string

The promotion type to apply.

string

The mart ID for the various markets are: - WALMART_CA for CA - WALMART_MEXICO for MX - WALMART_CHILE for CL.. __Market availability: CA | MX | CL__

string

Indicates where a promotion is applied or displayed. Allowed: `MAP Cart` __Market availability: US__

string

The promotion identifier. Provide this if updating or deleting an existing promotion.

string

The UTC date and time when the promotional price becomes effective.

object
string

Origin of the data. Use `EXTERNAL` for partner submitted feeds. __Market availability: CA | MX | CL__

string

The UTC date and time when the promotional price ends.

string

The tenant identifier for the marketplace. For example, use: - `WALMART_CA` for CA - `WALMART_MEXICO` for MX - `WALMART_CHILE` for CL. __Market availability: CA | MX | CL__

string

The type of feed for this request. Allowed Value: `PRICE_AND_PROMOTION` __Market availability: CA | MX | CL__

string

ItemFeed subcategory for price update. Market availability: CA | MX | CL

string

The feed processing behavior. Use `REPLACE` to overwrite existing values. __Market availability: CA | MX | CL__

Uncommon arguments
stringrequired

The feed Type. Allowed Value: `PRICE_AND_PROMOTION` __Market Availability: Global__

object

Defaults to US Marketplace settings. For CA, MX and CL, all fields except ("businessUnit") are required.

Every app you connect,one REST pattern

Call any app with one REST pattern. MindCloud handles each provider's auth, request shape, and responses for you.

Learn what the Universal API is
One REST patternUse the same request structure across apps like Slack, HubSpot, Salesforce, and thousands more.
Managed connectionsSend a MindCloud connection ID instead of handling provider tokens, refresh logic, and credential storage yourself.
Action-level docsEach action page shows the exact endpoint, required arguments, optional controls, and response behavior for that app version.