Guides
My Account

Get started as a seller

You can learn more about what is required to become a seller in the Before you start selling on Walmart Marketplace guide. This guide assumes you want to integrate with Walmart’s APIs. You do not need to use APIs to become a seller on Walmart’s Marketplace. If you do not want to use the Marketplace APIs, follow the instructions in the Complete onboarding in Seller Center guide.

Register as a seller

Once you are ready, complete the steps below:

  1. Follow the Complete onboarding in Seller Center guide on Marketplace Learn to onboard and register as a Walmart seller.
  2. Ensure you are approved to sell your items on Walmart Marketplace.
  3. (Option one) Sign in to the Developer Portal, under My Account, to retrieve your API key and start using Walmart Marketplace APIs.
  4. (Option two) Connect with an approved Solution Provider to assist you in managing your eCommerce business.

Retrieve your API keys (Option one)

As a seller, you can use APIs to manage your business on Walmart Marketplace. To access the Marketplace APIs, you must obtain a clientID and clientSecret for authentication.

Retrieve your API keys (clientID and clientSecret)

  1. Navigate to the API Integration page in Seller Center.
  2. Select API Key Management to sign in to the Developer Portal with your Seller Center credentials.
  3. From there, locate your personal (it has a lock icon next to it) Client ID and Client Secret.

Retrieve your API access token

Before you can make API calls, you must retrieve your API access_token. There are two methods to retrieve your access_token.

Method one: Token API in Postman

  1. Fork the Authentication API on Postman.
  2. Add your clientID and clientSecret as variables.
  3. Set up the Authentication to use Basic Auth with your clientID and clientSecret as the Username and Password (respectively).
  4. Set the POST Token API to Inherit auth from parent.
  5. Call the Post Token API. The response contains your access_token.
  6. (Optional) Under the Scripts tab, you can add the following script to the Post-response section to automatically update your access_token and add it as an Environment Variable each time you call the Post Token API. By default, the variable is named, token. You can change the name to something of your choice.
pm.test("STATUS is 200", function () { pm.response.to.have.status(200);
}); var response = pm.response.json();
pm.environment.set("token", response.access_token);

Method two: Command line

  1. Call the Token API with a Base64 (utf-8, Unix newline separators) encoding of your client ID and client secret to generate the access_token. The encoded string is used for the Authorization header parameter.

Use the following Python script to encode your confidential client ID and client secret offline. Swap out the placeholders, and with your actual values.

import base64 client_id = "your-client-id"
client_secret = "your-client-secret"
credentials = f"{client_id}:{client_secret}"
encoded_bytes = base64.b64encode(credentials.encode('utf-8'))
encoded_string = encoded_bytes.decode('utf-8') print(encoded_string)
  1. Use the following Python command to call the Token API and retrieve your access_token. Swap out <randomly-generated-GUID> with a randomly generated GUID.
curl --request POST --url https://marketplace.walmartapis.com/v3/token --header 'Authorization: Basic <base64(client_id:client_secret)>' --header 'Content-Type: application/x-www-form-urlencoded' --header 'WM_QOS.CORRELATION_ID: ' --header 'WM_SVC.NAME: Walmart Marketplace' --header 'accept: application/json' --data 'grant_type=client_credentials' 
import requests import base64 import uuid # Replace these with your actual client ID and client secret client_id = 'your_client_id' client_secret = 'your_client_secret' # Encode client credentials encoded_credentials = base64.b64encode(f"{client_id}:{client_secret}".encode()).decode() url = "https://marketplace.walmartapis.com/v3/token" payload = { "grant_type": "client_credentials" } headers = { "accept": "application/json", "Authorization": f"Basic {encoded_credentials}", "Content-Type": "application/x-www-form-urlencoded", "WM_QOS.CORRELATION_ID": str(uuid.uuid4()), # Generate a random GUID "WM_SVC.NAME": "Walmart Marketplace" } response = requests.post(url, data=payload, headers=headers) print(response.text)

Use Walmart Marketplace applications from an approved Solution Provider (Option two)

Sellers on Walmart Marketplace can enhance their business management by leveraging authorized connections with approved Solution Provider applications. These applications simplify tasks such as item setup and management, inventory, order fulfillment, pricing, and more.

Find an approved Solution Provider

  1. Understand the types of services you may need for your business.
  2. Find an approved Solution Provider in Walmart’s network of premier Solution Providers and agencies.
  3. Authorize and manage your Solution Provider applications through the App Store in the Seller Center or the API Key page.

Connect to an approved Solution Provider

There are two methods for connecting an approved Solution Provider to your Walmart Marketplace seller account. The simplest method is to use the Connect button (OAuth 2.0) available from select approved Solution Providers. The other method is to create delegated keys for your selected Solution Provider.

The Delegated Access method is no longer supported. Moving forward, all approved Solution Providers are expected to use OAuth 2.0.

Connect to an approved Solution Provider with OAuth 2.0

  1. In the Seller Center, from the left navigation menu, select Apps.
  2. Select App Listings and browse to select your Solution Provider. They should be on the list if you are already working with a Solution Provider.
  3. Select Connect to navigate to the Solution Provider's website.
  4. Typically, the site requires you to create an account or sign in for access.
  5. After you sign in, review the authorization information.
  6. If you agree, select the checkbox. Then, select Authorize to continue.
  7. (Optional) You could select Decline to stop the authorization process.

Do not share your Client ID and Client Secret information via email or other unsecure methods. Always use the secure methods provided by the approved Solution Providers’ platforms.

Access the Walmart Marketplace sandbox

The Marketplace API Sandbox is a tool you can use to test APIs and integrations. Review the Walmart sandbox guide and FAQs to learn how to access and use the Walmart Marketplace API Sandbox.

Get additional help

For additional support on all aspects of selling on Walmart.com, refer to the Walmart Marketplace Learn knowledge base. It covers a wide range of topics, including Variant Setup, Swatches, and more.

Updated about 4 hours ago