Walmart Marketplace
Connect Walmart Marketplace to manage orders, items, inventory, prices, promotions, returns, feeds, reports, and repricer rules for your seller account.
You end up pasting the Client ID and Client Secret of your own seller key pair from the Walmart Developer Portal, plus the word production or sandbox for the Environment field.
Seller/marketplace approval before this connector works
Walmart must approve your Marketplace seller application (or approve your company through the Solution Provider programme) before Seller Center exists for you. The developer docs state plainly that you must 'ensure you are approved to sell your items on Walmart Marketplace' before you can reach the keys.
- Typical wait
- Walmart publishes no SLA for the seller application - the developer docs and Marketplace Learn state no timeframe. Seller-community reports cluster around 5-10 business days, with clean US applications sometimes clearing in 24-48 hours and mismatched or incomplete ones running several weeks. Treat any specific number as unofficial.
- Cost
- Free to apply - Walmart charges no setup or monthly Marketplace fee. Referral fees (a percentage of each sale, varying by category) apply once you are live.
- Blocked until approved
- Everything. The Client ID and Client Secret live in the Developer Portal, which you sign into with Seller Center credentials via Seller Center > API Integration > API Key Management. No approved seller account means no Seller Center login, so no key pair, so no OAuth token - and Items, Orders, Inventory, Prices, Reports and the sandbox all sit behind that same token.
- Works meanwhile
- Read-only preparation. The developer.walmart.com reference, the API Explorer and the published Postman collections are public, so you can write and shape request/response handling against the documented schemas. You cannot execute a single authenticated call, sandbox included.
Where to apply: Sellers: apply at marketplace.walmart.com/us/apply with your business tax ID and W-9, EIN-matching legal name, verified address and marketplace/ecommerce history. Software vendors integrating on behalf of other people's stores apply separately through the Walmart Solution Provider programme.
- The most commonly reported rejection cause is a mismatch between the legal business name, EIN/tax ID and address on the application and the official tax records Walmart cross-checks against.
- Walmart looks for evidence of an ecommerce track record (GTIN/UPC-catalogued products, marketplace sales history, US fulfilment capability); thin dropship-arbitrage applications are frequently declined.
- Approval is only step one - onboarding (tax forms, shipping templates, a test order) must complete before the account leaves setup and API writes behave normally.
- For software vendors: Walmart's docs state creating new Delegated Access keys was retired on July 30, 2026, and existing Delegated Access keys stop working at the end of September 2026. The replacement is OAuth 2.0 seller authorization via the Connect flow in the Walmart App Store.
- Access tokens are short-lived (15 minutes), so a working integration must refresh continuously rather than caching a token.
- Country marketplaces are separate programmes: US, Canada and Mexico approvals, Seller Centers and Developer Portals do not carry over.
- Setup time
- 5 min
- Auth
- API credentials
- API base URL
- https://marketplace.walmartapis.com/v3
Before you begin
- A live US Walmart Marketplace seller account with Seller Center access
- Seller Center sign-in credentials, which are what the Developer Portal asks for when you click API Key Management
- Admin-level access in Seller Center so you can open the API Integration page
- Production keys exist only for a launched seller account. A Dynamic sandbox key pair is separate and cannot be used against production
Get your credentials
Open API Key Management from Seller Center
Sign in to Seller Center, open the API Integration page at seller.walmart.com/api-key, and select API Key Management. Sign in to the Developer Portal with your Seller Center credentials when prompted.
Find your own key pair on My Account → API Keys
On My Account → API Keys, locate your personal key pair, which has a lock icon next to it. Ignore rows without a lock, which belong to solution providers you have authorized.
API Keys
Keys issued to your seller account and to solution providers you have authorized.
| Key pair | Client ID | Type | Status |
|---|---|---|---|
| My key pairLocked to this seller account | b7e4****2f9a | Seller | Active |
| Feed Partner AppSolution provider | a11c****8d30 | Delegated | Active |
Only the locked row carries the full Marketplace permissions for your seller account.
Copy the Client ID and Client Secret
Click Show beside the secret on the locked row. Copy the Client ID and the Client Secret into PopMCP.
API Keys
- Production
- https://marketplace.walmartapis.com/v3/token
- Dynamic sandbox
- https://sandbox.walmartapis.com/v3/token
- Access token lifetime
- 15 minutes (900 seconds)
PopMCP stores the pair encrypted and mints short-lived tokens server-side.
Set the Environment field to match the key
Leave Environment as production for a live seller key. Enter sandbox only if the pair you copied is a Dynamic sandbox key.
Connect in PopMCP
Open your workspace, choose Walmart Marketplace in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| Auth typepreset | Walmart Marketplace uses OAuth client-credentials. Create the key in Seller Center → Developer Portal → API Key Management. We only ever store the Client ID / Client Secret (encrypted) and mint short-lived tokens from them server-side. |
| Client IDtext | From Seller Center → Developer Portal → API Key Management. Make sure it matches the environment you pick below. |
| Client Secretsecret | The secret paired with your Client ID. Stored encrypted; used server-side only to mint short-lived access tokens.Encrypted with AES-256-GCM on save and never shown again. |
| Environmenttext | Leave as "production" for a live Walmart seller account. Enter "sandbox" only if your Client ID / Client Secret is a Sandbox key. A sandbox key will not work against production, or vice-versa. |
PopMCP verifies the credential against Walmart Marketplace immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
PopMCP shows the Walmart Marketplace connector as Connected and lists your seller id together with a recent orders count, confirming a token was minted from the token endpoint.
Troubleshooting
401 Unauthorized on every call
Why: The Client ID and Client Secret belong to a different environment than the one selected, or were copied from an unlocked solution-provider row.
Fix: Recopy from the row with the lock icon on My Account → API Keys and match Environment to the key, production with production and sandbox with sandbox.
Token works, then stops after a few minutes
Why: Walmart access tokens are valid for 15 minutes (900 seconds).
Fix: Nothing to do, PopMCP refreshes tokens server-side. If it persists, reconnect so a fresh token is minted.
Sandbox calls return production-shaped errors
Why: The request was not routed to the Dynamic sandbox.
Fix: Set Environment to sandbox so PopMCP sends the WM_SANDBOX: v2 header and targets https://sandbox.walmartapis.com.
No key pair is listed at all
Why: The seller account has not been launched, or you signed in with a user that is not attached to the seller account.
Fix: Start from seller.walmart.com/api-key with the Seller Center account that owns the marketplace listing, then select API Key Management again.