Update promotional price for a single item

put

https://marketplace.walmartapis.com/v3/price

Updates the promotional price.

Use this API to update or delete an existing promotional price as well as set up a new promotional price.

To set a new promotional price or update an existing one, set the pricing attribute `processMode` to `UPSERT`.
To delete a promotional price, set the pricing attribute `processMode` to `DELETE`.
To delete all promotions for a SKU, set `replaceAll` to an empty payload.

For more information and usage examples, refer to the Marketplace Promotions API Guide.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

promo

boolean

required

Defaults to true

Indicates the promotional price. To retrieve the promotional prices, set this value to true.

Body Params

SON payload specifying the SKU and promotional pricing details. To remove all promotions for a SKU, set replaceAll and provide an empty pricing array.

offerId

string

Applicable only for promotions. Indicates the promotional offer being applied.

sku

string

required

SKU of the item for which the promotional price is being updated.

replaceAll

string

enum

Applicable only for promotions. Indicates whether to replace all existing promotions for the SKU.

Allowed:

pricing

array of objects

required

pricing*

definitions

object

Headers

WM_SEC.ACCESS_TOKEN

string

required

Access token obtained from the Token API. This is required for authenticating requests to Walmart Marketplace APIs.

WM_CONSUMER.CHANNEL.TYPE

string

A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding.

WM_QOS.CORRELATION_ID

string

required

A unique ID that identifies each API call and is used to track and debug issues. Use a randomly generated GUID for this ID.

WM_SVC.NAME

string

required

Specifies the name of the Walmart service being called.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Response

200Successful Operation