Bulk item setup
The Bulk item setup API lets you set up and maintain items in bulk. Use this API for initial item setup and maintenance. This endpoint supports multiple feed types, and the payload structure depends on the feed type you select.
Endpoint
POST https://marketplace.walmartapis.com/v3/feeds?feedType={feedType}How feed submissions work
The Bulk item setup API uses feeds to submit item data for asynchronous processing. A feed contains one or more item records that Walmart processes in bulk.
You can submit a feed in either of these ways:
- Upload a feed file using
multipart/form-data. - Send the JSON payload directly in the request body using
application/json.
After you submit the feed, the API returns a feedId. Use the feedId to track processing status and review results.
Limits and sizing guidelines
- Up to 10,000 items per request. Feeds larger than 10,000 items aren’t supported.
- Keep feed files under 25 MB for optimal processing time.
- FITMENT_ACES and FITMENT_PIES support files up to 50 MB.
Supported feed types
The Bulk Item Setup API supports all feed types and spec versions identified in the Item spec: Versioning and diff reporting article. Make sure to include the correct feedType as a query parameter in your request.
Response (200)
{ "feedId": "F129C19240844B97A3C6AD8F1A2C4997@AU8BAQA" }Common item management workflows
| Goal | Feed type | Availability | Guide |
|---|---|---|---|
| Create an offer for an existing Walmart catalog item | MP_ITEM_MATCH | Global | Create an offer for an existing Walmart item |
| Create a new seller-fulfilled item | MP_ITEM | US, CA | Create a new item |
| Update existing items | MP_MAINTENANCE | Global | Update existing items |
| Create a new Walmart-fulfilled item | MP_WFS_ITEM | US, CA | Set up items for WFS |
| Convert a seller-fulfilled item to Walmart-fulfilled | OMNI_WFS | US only | Convert items for WFS |
| Retire items | RETIRE_ITEM | US only | Retire an item |
| Delete seller-fulfilled items | DELETE_ITEM | US only | Bulk item delete |
| Manage automotive fitment data | FITMENT_ACES, FITMENT_PIES | US only | Automotive fitment |
| Map SKUs to shipping templates and fulfillment centers | SKU_TEMPLATE_MAP | Global | SKU template mapping |
| Manage shipping overrides | SHIPPING_OVERRIDES | US only | Shipping overrides |
| Split or merge item relationships | SPLIT_AND_MERGE | US only | Split and merge item relationships |
| Set up items for international marketplaces | MP_ITEM_INTL | CA, MX, CL | International item setup guide |
| Set up Walmart-fulfilled items in supported international markets | OMNI_WFSSETUP | CA, MX | WFS setup guide |
| Create or maintain virtual pack bundles | MP_VIRTUAL_PACK_BUNDLE | US only | Virtual pack guide |
Submit a feed
Option 1: Upload a file (recommended for large feeds)
curl --request POST \ --url "https://marketplace.walmartapis.com/v3/feeds?feedType=MP_ITEM" \ --header "WM_SEC.ACCESS_TOKEN: <ACCESS_TOKEN>" \ --header "WM_QOS.CORRELATION_ID: <UUID>" \ --header "WM_SVC.NAME: Walmart Marketplace" \ --header "accept: application/json" \ --header "content-type: multipart/form-data" \ --form "file=@./feed.json"Option 2: Send an inline JSON payload
curl --request POST \ --url "https://marketplace.walmartapis.com/v3/feeds?feedType=MP_ITEM" \ --header "WM_SEC.ACCESS_TOKEN: <ACCESS_TOKEN>" \ --header "WM_QOS.CORRELATION_ID: <UUID>" \ --header "WM_SVC.NAME: Walmart Marketplace" \ --header "accept: application/json" \ --header "content-type: application/json" \ --data '{ "payload": { "...": "..." } }'Tip: Download and review the request body samples ZIP linked from the Bulk item setup API reference to confirm formatting before you upload.
Next steps
- Track the
feedIdusing your feed status workflow and retrieve the processing report/error output. - Validate your payload structure against the latest spec versioning guidance and samples.
Updated about 3 hours ago