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 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.

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.

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.