Use this API for initial item setup and maintenance.

This API updates items in bulk, allowing you to update up to 10,000 items at once. Updates with more than 10,000 items are not supported. To ensure optimal feed processing time, keep feed sizes below 25 MB, except for FITMENT_ACES and FITMENT_PIES feeds, which support files up to 50 MB.

The bulk item setup API supports requests in two formats: file as an attachment or provide the JSON payload directly in the request body. The API supports all feed types and spec versions identified in the Item spec: Versioning and diff reporting article. Make sure to include the correct feed type as a query parameter in your request. Available feed types:

• MP_ITEM: Set up a new seller fulfilled item.
• MP_WFS_ITEM: Set up a new Walmart fulfilled item.
• MP_MAINTENANCE: Update existing items in your catalog.
• MP_ITEM_MATCH: Use item setup info from an existing Walmart catalog item to set up your own offer.
• OMNI_WFS: Convert a seller fulfilled item to Walmart fulfilled item.
• FITMENT_ACES/FITMENT_PIES: For automotive fitment items. Requires a zip file in the request body.
• DELETE_ITEM: Delete seller-fulfilled items from your catalog.

To create or manage variant groups, use feedType=MP_ITEM or feedType=MP_MAINTENANCE. In the Visible.[ProductType] block for each item, include variantGroupId, isPrimaryVariant, and variantAttributeNames. Use the following values:

• variantGroupId: The group ID
• isPrimaryVariant: Use Yes for exactly one item per group and No for all others
• variantAttributeNames: An array of up to three attribute names (for example, color and size)

Items that share the same variantGroupId within a single feed are grouped together.

Download and review the request body samples for guidance on formatting the updated feed file before uploading it for processing.