Introduction to Walmart Marketplace APIs

Walmart Marketplace is an eCommerce platform operated by Walmart that enables third-party sellers to list and sell products directly on Walmart.com, reaching millions of customers across the U.S. Marketplace supports a wide range of sellers, from small and medium businesses to large brands, offering the infrastructure needed to manage listings, orders, fulfillment, and post-purchase experiences at scale.

The Walmart Marketplace APIs provide programmatic access for sellers and approved solution providers to integrate directly with Marketplace systems. These APIs enable you to manage key aspects of your business on Walmart.com, including items, inventory, orders, pricing, promotions, reporting, and other operational workflows. By integrating with the Marketplace APIs, you can automate processes, reduce manual effort, and build custom tools or platform integrations that support your business needs.

The Walmart Developer Portal serves as the central hub for Marketplace API integration. It provides access to API documentation, credentials, authentication guidance, and onboarding resources needed to build, test, and maintain integrations with Walmart Marketplace.

If you are new to Walmart Marketplace, start by reviewing the basic eligibility requirements and onboarding steps in the Getting Started guide. The guide walks you through account setup, API access, and initial integration, helping you move from registration to selling on Walmart.com. Whether you are an independent seller or an established brand, these resources are designed to help you successfully launch and scale your Marketplace business.

Before you begin

Before calling Marketplace APIs, complete the onboarding requirements for your role and set up API access.

API credentials

Generate a Client ID and Client Secret in the Walmart Developer Portal. These credentials identify your application and are required to request access tokens for Marketplace APIs.

Authentication and authorization

Walmart Marketplace APIs use OAuth 2.0 for authentication.

• Include a valid OAuth 2.0 access token with each API request.
• Access tokens are valid for 15 minutes.
• Use the expires_in value to track token expiration and request a new token as needed.

For token request instructions, refer to Get an access token using Token API. Applications that connect to seller accounts should also review OAuth 2.0 authorization.

Test your integration with Dynamic sandbox

The Dynamic sandbox is a self-service testing environment that lets you build and validate your Marketplace integration before going live. Unlike the static sandbox, it supports custom test data and end-to-end workflow testing without affecting production systems or Seller Center.

Use the Dynamic Sandbox to:

• Create custom test items and inventory.
• Simulate customer and carrier actions, such as placing orders, deliveries, and returns.
• Validate end-to-end Marketplace workflows.
• Test business validations and error handling before deploying to production.

To get started, learn how to access the Dynamic sandbox and explore the step-by-step recipes for common Marketplace workflows.

• Dynamic sandbox guide: Learn how to access the environment, create test data, and use Simulation APIs.
• Dynamic sandbox recipes: Follow guided workflows for inventory, orders, returns, and refunds.

Related links

Use the following resources to start selling on Walmart Marketplace using the Marketplace APIs.

• Get an access token using Token API - Details how to use the Token API endpoint to obtain OAuth 2.0 access tokens for Walmart Marketplace APIs. Retrieving access tokens is essential to start integrating with Marketplace APIs.
• Get started as a seller - Provides information on how to register as a seller and provides options on how you can access the Marketplace APIs. You can either choose to directly integrate with the APIs or leverage authorized connections with approved solution providers.
• Get started as an approved Solution Provider - Provides information on how companies can be approved Solution Providers to develop software that could improve sellers’ eCommerce workflows.
• Integrate with Walmart Marketplace APIs - Provides information on available integration guides that show you how to use the Marketplace APIs and provides API integration options.
• OAuth 2.0 authorization - Learn more about the Walmart Marketplace app store authorization workflow. Walmart incorporates an industry-standard OAuth 2.0 token-based authorization and authentication.