Bulk item setup

The Bulk item setup API lets you create and update 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 feed files to submit data for processing. A feed is an API request with an attached file (often called a feed file or load file). The feed file contains a list of records (for example, items) that Walmart processes in bulk.

You can also add this optional follow-on sentence (if you want it slightly more complete, still concise):

After you submit the feed, the API returns a feedId that you use to track processing 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.

• You can submit payloads as:

  • File upload: Content-Type: multipart/form-data
  • Inline JSON: Content-Type: application/json

Supported feed types

The API supports all feed types and spec versions identified in the Bulk item setup API reference. Make sure to include the correct feedType as a query parameter in your request.

Available feed types:

• MP_ITEM_MATCH: Create an offer using item setup info from an existing Walmart catalog item.
• MP_ITEM: Set up a new seller-fulfilled item.
• MP_MAINTENANCE: Update existing items in your catalog.
• MP_WFS_ITEM: Set up a new Walmart-fulfilled (WFS) item.
• OMNI_WFS: Convert a seller-fulfilled item to a Walmart-fulfilled item.
• FITMENT_ACES / FITMENT_PIES: Automotive fitment items (requires a .zip file in the request body).
• DELETE_ITEM: Delete seller-fulfilled items from your catalog.
• RETIRE_ITEM: Retire items by SKU in bulk.
• SKU_TEMPLATE_MAP: Map SKUs to shipping template and fulfillment center.
• SHIPPING_OVERRIDES: Add or update shipping overrides per SKU.
• SPLIT_AND_MERGE: Perform split/merge operations for item relationships.

Required headers

• WM_SEC.ACCESS_TOKEN
• WM_QOS.CORRELATION_ID
• WM_SVC.NAME
• Content-Type: multipart/form-data or application/json
• Accept: application/json (XML response is also supported)

Response (200)

{ "feedId": "F129C19240844B97A3C6AD8F1A2C4997@AU8BAQA" }

Common item management workflows

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 page to confirm formatting before you upload.

Next steps

• Track the feedId using your feed status workflow and retrieve the processing report/error output.
• Validate your payload structure against the latest spec versioning guidance and samples.