Walmart Marketplace
Move Walmart Marketplace orders, products and stock to the rest of your business without re-keying.
30 ways to read, 7 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with Walmart Marketplace, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Acknowledge orderApproval by rule
- Ship order linesApproval by rule
- List reconciliation report datesRead
Example flow
- Walmart Marketplace · List reconciliation report datesDone
- Walmart Marketplace · Acknowledge orderNeeds approval
- Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Walmart Marketplace.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to Walmart Marketplace
- Walmart Marketplace's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect a Walmart test account before you go live.
For developers
Technical detail
Walmart Marketplace items, multi-node and WFS inventory, prices, orders, returns, reports, reconciliation, lag time, settings and listing quality; stock, price and shipping writes.
Walmart API docs- Source actions
- 30
- Destination actions
- 7
- Data types
- 26
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
Feeds2
- Get feed item statusSource
A feed's status with per-item ingestion results and errors.
- List feed statusesSource
Bulk feed submissions with received, succeeded and failed counts.
Inventories3
- Get multi-node inventorySource
Quantities for one SKU across all ship nodes, or one node.
- List multi-node inventorySource
Input, available-to-sell and reserved quantity per ship node for every SKU (multi-node sellers).
- Update multi-node inventoryDestinationProvider duplicate protectionApproval before production
Set a SKU's quantity at one or more ship nodes (overwrites each node's stock).
Inventory2
- Get inventorySource
Available quantity for a SKU.
- Update inventoryDestinationProvider duplicate protectionApproval before production
Set the available quantity for a SKU (overwrites the current stock).
Items3
- Get itemSource
One item by SKU.
- List itemsSource
Catalogue items with publish and lifecycle status.
- Search catalog itemsSource
Search the seller's catalog by product name, SKU, GTIN, UPC, WPID or item ID, optionally filtered by lifecycle or published status.
Lag times2
- Get lag timeSource
Fulfilment lag time (days between order and shipment) for a SKU.
- Update lag timesDestinationNot retried automaticallyApproval before production
Submit a lag time feed setting fulfilment lag time (days) for one or more SKUs; track it with Get feed item status.
Listing quality items1
- List listing quality by itemSource
Per-item quality scores and issues, optionally for one SKU.
Listing quality1
- Get listing quality scoreSource
Overall listing quality with offer, content, rating, price and shipping sub-scores.
Order acknowledgements1
- Acknowledge orderDestinationProvider duplicate protectionApproval before production
Acknowledge a purchase order so it can be shipped.
Order shipments1
- Ship order linesDestinationNot retried automaticallyApproval before production
Mark order lines shipped with carrier and tracking details.
Orders2
- Get orderSource
One purchase order with lines, charges and line statuses.
- List ordersSourceIncremental
Seller-fulfilled orders modified (or created) since a date, by status.
Partner profile1
- Get partner profileSource
Seller account profile and feed throttling configuration.
Prices1
- Update priceDestinationProvider duplicate protectionApproval before production
Set an item's BASE, REDUCED or CLEARANCE price (explicit amount only).
Promotional prices1
- Get promotional pricesSource
Promotional (REDUCED or CLEARANCE) prices scheduled for a SKU.
Recon report dates1
- List reconciliation report datesSource
Settlement dates for which a payment reconciliation report is available.
Recon reports1
- List reconciliation report linesSource
Payment reconciliation (settlement) report lines for a date: sales, refunds, fees and payment summaries.
Released orders1
- List released ordersSourceIncremental
Orders released for fulfilment (status Created) that still need acknowledgement.
Report downloads1
- Get report downloadSource
A ready report's pre-signed download URL and its expiry.
Report requests3
- Request reportDestinationNot retried automaticallyApproval before production
Request an on-demand report (for example ITEM or INVENTORY).
- Get report requestSource
Status of one on-demand report request.
- List report requestsSource
On-demand report requests for a report type with their status (last 30 days).
Returns2
- Get returnSource
One return order (RMA) with lines, labels and refund totals.
- List returnsSourceIncremental
Return orders modified (or created) since a date with lines and refund totals.
Ship nodes1
- List fulfilment centresSource
The seller's ship nodes (fulfilment centres) with address and services.
Shipping configurations1
- Get shipping configurationSource
Default fulfilment lag time per category and other shipping settings.
Shipping templates1
- List shipping templatesSource
Shipping templates with type, status and rate model.
Unpublished items1
- List unpublished itemsSource
Items unpublished since a date with the reason, price and page views.
Wfs inbound shipment items1
- List WFS inbound shipment itemsSource
Items on WFS inbound shipments with expected, received and damaged quantities.
Wfs inbound shipments1
- List WFS inbound shipmentsSourceIncremental
Walmart Fulfillment Services inbound shipments with status and received units.
Wfs inventory1
- List WFS inventorySourceIncremental
On-hand and available quantity held in Walmart fulfilment centres, by SKU.
Access and limits
- Authentication
- Walmart client ID and client secret (client-credentials token)
- Plans and access
- Approved Walmart Marketplace (US) sellers. Client ID and secret are generated in Seller Center Developer Portal; delegated access for solution providers uses different keys.
- Test environment
- Walmart offers a sandbox host with mock data (sandbox.walmartapis.com); this connection targets production.
- Rate limits
- Token buckets per seller and endpoint: items 300/min (60/min with filters), catalog search 1,000/hour, single item 900/min, orders 5,000/min, acknowledge and ship 60/min, inventory 200/min, price 100/hour, returns 50/min, feeds 5,000/min, report requests 200/min and downloads 20/hour. x-current-token-count and X-Next-Replenishment-Time report the bucket; HTTP 429 when empty.
- Pagination
- Items, catalog search, multi-node inventory and listing quality return nextCursor tokens; orders, released orders and returns return a query string that Nexra appends unchanged. Feeds and WFS use offset and limit; reconciliation lines use offset with nextOffset.
- Provider events
- Event notifications for orders, items, inventory and reports. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
Before you build a flow
- US marketplace only; Canada and Mexico use different hosts and authentication.
- Intentionally excluded: refunds (issue refund, refund order lines), order and WFS shipment cancellations, item retirement, report schedule and notification subscription deletes, and shipping template or fulfilment centre changes.
- Promotional prices are read-only; price updates set only BASE, REDUCED or CLEARANCE prices from explicit input.
- Lag time updates are submitted as a lagtime feed and processed asynchronously; read the feed status for the outcome.
- Reconciliation lines carry no Walmart identifier, so Nexra derives a stable ID by hashing each line. The legacy (non-v1) reconciliation format and zipped CSV downloads are not read.
- Walmart no longer documents a separate Rules API; shipping settings are read from the Settings APIs (templates, ship nodes, partner and shipping profiles).
- Unpublished items return a single page (Walmart documents only a limit).
- Walmart documents no idempotency key; ship-with-tracking and report requests are not repeated automatically when the outcome is uncertain.
- Item creation uses bulk feeds (MP_ITEM spec), which are not implemented; feed status reads are available.
- Order lists cover the last 180 days (maximum 10,000 per query).
- Report downloads return a pre-signed URL that Nexra does not fetch.
Developer reference
- Create the Walmart credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose Walmart Marketplace, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/walmart-marketplace and the Connections API.