Create items on Walmart.com

For endpoint details and feed formats, refer to the bulk item setup API.

These steps are recommended to create items on Walmart.com. Start by checking whether you’ve already set up the item in your Seller Catalog, then confirm whether the item exists in the Walmart catalog.

Optional: Check your seller catalog first (recommended)

Use the catalog search API to search your seller catalog and confirm whether the item already exists in your catalog (for example, by SKU, GTIN/UPC, or product name). This is helpful if you’re not sure whether the item was already created, unpublished, or retired.

Refer to: catalog search API

Use it to:

• Find items by identifiers (SKU, WPID, UPC, GTIN)
• Check lifecycle/publication status (ACTIVE/RETIRED, PUBLISHED/UNPUBLISHED)
• Review variant group details when available in results

Step 1: Search for the item

Use the item search API to check if the item you’re trying to set up already exists in the Walmart catalog.

Refer to: Item Search API

Step 2: Create an offer for an existing Walmart item (Offer setup by match)

If your item appears in search results, create your offer using offer setup by match. This approach uses existing Walmart catalog item information and typically requires only a small set of offer-specific attributes.

Refer to: Create an offer for an existing Walmart item (MP_ITEM_MATCH)

Step 3: Create a new item (Full item setup)

If your item doesn’t appear in search results, use full item setup to create and publish a new item to the Walmart catalog using the Bulk Item Setup API.

Refer to: Create a new item (Full item setup)