The Walmart connector links your Walmart Marketplace account to the app. The app pulls orders, returns, and ship nodes from Walmart, sends fulfillments and inventory back to Walmart, and can pull or push your product catalog. It supports Walmart Marketplace US and Canada.
With this connector, you can:
- Pull orders from Walmart into the app, filtered by order type and state.
- Push fulfillments with tracking numbers to Walmart, or pull fulfillments from Walmart.
- Push inventory to Walmart, or pull inventory from Walmart, including WFS inventory.
- Pull products from Walmart, or push products from the app to Walmart.
- Pull returns from Walmart and refund received returns in Walmart.
- Pull your Walmart ship nodes into the app as locations.
Setup
Before you begin, make sure you have:
- A license for the Walmart connector.
- A Walmart Seller Center account. You approve the connection by signing in to it, so you don’t need an API key.
- Pop-up blockers turned off in your browser.
To connect Walmart:
- Navigate to Integrations in the app.
- Click Add Integration, and then select Walmart.
- In Select Walmart Marketplace environment, select Walmart Marketplace US (Global API), Walmart Marketplace Canada (Global API), or Walmart Marketplace Canada (legacy).
- To connect with Walmart authorization (recommended), leave Client ID and Client Secret empty, click Connect, and then sign in with your Walmart Seller Center account to authorize Pipe17.
- If you already connected with a Walmart API key created for Pipe17, it keeps working for now. Walmart stopped issuing these keys on July 30, 2026, and they stop working on April 30, 2027. Before then, reconnect with Walmart authorization: open the integration, clear Client ID and Client Secret on the Connection Details tab, and reconnect to authorize with Walmart. To learn more, see Walmart’s Delegated Access page.
- Navigate to Integrations. Walmart shows Connected. If it shows Error or Not Configured, open it, check your credentials on the Connection Details tab, and click Save.
- Make sure the switch on the integration’s row is on.
- In the integration settings, turn on Pull locations (ship nodes) from Walmart and Pull orders from Walmart, and then choose the directions you need in Process fulfillments, Process product catalog updates, Process inventory information, and Process returns.
- Navigate to Inventory > Locations. Open the Walmart location that holds inventory from your 3PL or warehouse, click Merge location, and select the 3PL or warehouse location that's the source for that inventory. To learn more, see Merging Locations.
- Navigate to Order Routing and create a routing rule. Enter a Name, pick the Destination countries the rule applies to (leave it blank to route all orders the same way), and pick the Fulfillment Location that fulfills your Walmart orders. Save your changes.
- Test the setup. Check that inventory in the app matches your fulfillment location, and then create a test order in Walmart for an item that has inventory. The order appears in the app within 5 minutes and creates a shipping request for the fulfillment location in your routing rule.
Note: New, unfulfilled Walmart orders go through your routing rules and can be sent to fulfillment. Use the filters on the routing rule so that only your test order is routed while you test.
Note: Walmart’s deadline to move from the legacy Canada API to the Global API was July 31, 2026. If your integration still uses Walmart Marketplace Canada (legacy), switch Select Walmart Marketplace environment to Walmart Marketplace Canada (Global API), clear Client ID and Client Secret, and reconnect to authorize with Walmart. To learn more, see Walmart’s Switch to Global APIs guide.
Settings
| Setting | Description | Options/Default |
|---|---|---|
| Create WFS location to track Walmart fulfillable inventory quantities | By default, the app pulls only Seller Fulfilled ship nodes. Turn this on to create a virtual location in the app for your WFS inventory. | On/Off. Default: Off |
| Exclude orders created before this date | The app pulls only orders created after this date. After sync starts, the app processes orders as they're updated in Walmart, so if you set a date in the past, you still need to update an older order to pull it. | Optional. Default: integration creation date |
| Use customer order id as order number in Pipe17 | Uses the Walmart Customer Order # instead of the Purchase Order # to identify the order in the app. | On/Off. Default: Off |
| Pull only following orders from Walmart | The order types the app pulls. | Seller Fulfilled, Walmart Fulfilled, Partner Fulfilled. Default: Seller Fulfilled |
| Pull only orders in these states | The Walmart order states the app pulls. | Created, Acknowledged, Shipped, Delivered. Default: Created |
| Acknowledge orders automatically | Marks orders as Acknowledged in Walmart when the app pulls them. | On/Off. Default: Off |
| Cancel Pipe17 order when Walmart order gets cancelled | Cancels the order in the app when it's canceled in Walmart. | On/Off. Default: Off |
| When applying fulfillment, cancel lineItems not reported in first fulfillment | When on, the app cancels in Walmart everything the first partial fulfillment didn't ship, including line items it didn't include and unshipped units of a multi-unit line. When off, the app applies later partial fulfillments as they arrive. | On/Off. Default: Off |
| Apply product updates only for specific SKUs | Pulls or pushes products only for these SKUs. A plain value matches the SKU exactly, not case-sensitive. A value wrapped in slashes is a regular expression, for example /^ABC*/ matches SKUs that start with ABC. Use it for testing or a short list, because a long list slows processing. |
Optional |
| Force product catalog resync | Resyncs your whole product catalog, and then turns itself off when the sync starts. A full resync can take a long time and pauses the regular product sync. To resync one product, click Sync on the product details page. | On/Off. Default: Off |
| Push inventory information to Walmart in batches | Sends inventory updates in batches through Walmart feeds. Useful for large catalogs. | On/Off. Default: Off |
| Process only inventory items with specific SKUs | Pushes or pulls inventory only for these SKUs. Use it for testing, and leave it empty in production. | Optional |
| Report inventory totals from Pipe17 to dedicated Walmart location | The app adds up inventory from all active locations and sends the total to this one Walmart location. The location must exist in Walmart, so pull your ship nodes first. | Optional |
| Force inventory resync | Resyncs all inventory, and then turns itself off when the sync starts. A full resync can take a long time. | On/Off. Default: Off |
| Exclude returns created before this date | The app pulls only returns created after this date. Setting an earlier date later doesn't pull older returns. | Optional. Default: integration creation date |
Note: The app pushes products to Walmart in batches and creates one event for each batch, not for each product. A product push works only when the product has every property Walmart requires for its category. These properties usually don't exist in the app, so you might need to customize the product entity or use custom mappings.
Flows
| Flow | Direction | Notes |
|---|---|---|
| Locations | Walmart → Pipe17 | Runs every 5 minutes when Pull locations (ship nodes) from Walmart is on. Locations are required for order routing and inventory. To learn more, see Getting Started with Locations in Pipe17. |
| Orders | Walmart → Pipe17 | Runs every 5 minutes when Pull orders from Walmart is on. Pulls new and updated orders that match your order settings. After a shipping request reaches Sent To Fulfillment, updates such as cancellations no longer go to the 3PL. |
| Fulfillments | Pipe17 → Walmart or Walmart → Pipe17 | Runs every 5 minutes. In Process fulfillments, choose Push fulfillments to Walmart, Pull fulfillments from Walmart, or Push & pull fulfillments. Pushed fulfillments mark the Walmart order as fulfilled and send all tracking numbers. |
| Products | Walmart → Pipe17 or Pipe17 → Walmart | In Process product catalog updates, choose Pull products from Walmart or Push products to Walmart. Pushes run every 5 minutes. |
| Inventory | Pipe17 → Walmart or Walmart → Pipe17 | Runs every 5 minutes. In Process inventory information, choose Push inventory to Walmart, Pull inventory from Walmart, or Push & pull inventory information. When pushing, the app sends totals from all active locations by default. |
| Returns | Walmart → Pipe17, refunds Pipe17 → Walmart | Runs every 5 minutes. In Process returns, choose Pull returns from Walmart, or Pull returns & push refunds (refund received returns) to also refund received quantities in Walmart. Exchange returns aren't refunded. Requires the Returns permission and isn't available for Walmart Marketplace Canada (legacy). |
Integration actions
| Action | What it does |
|---|---|
| Pull orders from Walmart by external order IDs | Pulls the Walmart orders you list. |
| Pull orders from Walmart by date | Pulls orders created after a date, for a time interval from 1h to 48h (default 1h). |
| Pull returns from Walmart by date | Pulls returns modified after a date, for a time interval from 1h to 48h (default 1h). |
| Pull inventory from Walmart by SKUs | Pulls inventory for the SKUs you list. |
| Pull inventory from Walmart by date | Pulls inventory updated after a date, for a time interval from 1h to 48h (default 1h). |
Troubleshooting
- The integration stops with an authorization error
If you connected with a Walmart API key, it may have been revoked or expired. Reconnect with Walmart authorization: clear Client ID and Client Secret on the Connection Details tab, reconnect, and approve access in Walmart. - The Walmart authorization doesn't start when you click Connect
If Client ID or Client Secret has a value, the app uses the API key instead. Clear both fields to connect with Walmart authorization. Also turn off pop-up blockers. Walmart Marketplace Canada (legacy) always needs an API key, so switch to Walmart Marketplace Canada (Global API). - Orders from Walmart don't appear in the app
Check Pull only following orders from Walmart and Pull only orders in these states. By default, the app pulls only Seller Fulfilled orders in the Created state. Use Pull orders from Walmart by external order IDs to pull a specific order. - Inventory in Walmart doesn't match your warehouse
Make sure each Walmart location is merged with the 3PL or warehouse location that holds the stock, or set Report inventory totals from Pipe17 to dedicated Walmart location. - A product push to Walmart fails
Walmart requires category-specific properties that usually don't exist in the app. Add them to the product, or use custom mappings. - Refunds aren't created in Walmart for received returns
Set Process returns to Pull returns & push refunds (refund received returns), and if you connect with an API key, make sure it has the Returns permission with Full Access. Refunds aren't available for Walmart Marketplace Canada (legacy).
Need Help?
If you need additional assistance:
- Use Ask Pippen, our AI agent, located at the top of the platform page.
- Submit a support request with as much relevant detail as possible. Learn how to submit a request.
We’re here to help you succeed with your operations.
Comments
0 comments