Pricing & promotions

How can I set up promotions?

Use the Price Management and Promotional Price APIs to create and manage promotions for items on Walmart.com.

For more information, refer to the following resources:

Can an item be enrolled in both the Referral Reduced and Walmart Funded programs at the same time?

No. An item can only be enrolled in one incentive program at a time.

Can an item be switched from one incentive program to another?

Yes. An item can be switched between programs, provided the item is part of the recommended items list.

If I submit a price update, promo update, or combined price and promo feed for an item enrolled in an incentive program, will it affect the item’s reduced price or enrollment status?

No. Submitting price or promotion updates does not affect an item’s enrollment status or reduced price associated with either incentive program.

What is the best way to determine whether an item has been enrolled or unenrolled from an incentive program?

Use the Incentives API endpoint:GET /v3/price/incentives
This endpoint provides the current enrollment status for items participating in incentive programs.

How quickly is the data in the Incentives API updated?

The data returned by the Incentives API is updated in real time.

Is there a limit to how many items can be eligible for or enrolled in these incentive programs?

No. There is no cap on the number of items that can participate in either incentive program.

Are there any limitations when retrieving incentive program status for large catalogs?

The Incentives API currently supports:

A rate limit of 60 requests per hour
Up to 200 items per request

Large catalogs may require batching requests accordingly. However, there is no limit on the number of eligible or enrolled items.