New: Sandbox Pricing and Promo Simulations
Date: September 8, 2026
Walmart Marketplace now supports dynamic sandbox capabilities to selected Pricing and Promotions APIs. Partners can now update base prices and create, update, delete, or retrieve promotional prices using custom test items before moving your integration to production.
What changed
- Added
- Support to update base pricing for dynamic sandbox test items:
PUT v3/price
- Support to create, update, delete, and retrieve promotional pricing for dynamic sandbox test items:
PUT/v3/priceGET /v3/promo/sku/{sku}
- Support to update base pricing for dynamic sandbox test items:
- Updated
- Dynamic sandbox documentation to clarify that supported Pricing and Promotions APIs now use customizable partner-defined test data.
- API reference guidance to document use of the
WM_SANDBOX: v2request header for supported Pricing and Promotions endpoints.
- Impacted
- Base price testing workflows using dynamic sandbox item data
- Promotional pricing workflows for creating, updating, deleting, and retrieving promotional prices
- End-to-end pricing validation using custom sandbox test items
- Sandbox API requests using the
WM_SANDBOX: v2request header
Why it matters
- Dynamic sandbox support lets users test pricing and promotional workflows with custom item data.
- Partners can validate end-to-end price changes, promotion creation, promotion updates, promotion deletion, and promotional price retrieval before sending requests to the production environment.
Next steps
- Send eligible sandbox requests to
https://sandbox.walmartapis.com. - Include
WM_SANDBOX: v2in each request that should use the dynamic sandbox. - Create or update dynamic sandbox test items before testing pricing and promotional workflows.
- Confirm that integrations that require static mock responses omit the header or do not set it to
v2. - Account for dynamic sandbox limits and data retention when planning automated tests.
- For more information and usage examples, refer to the Pricing API Guide.

