Skip to main content

Set Up Item by Match

POST 

/api/walmart/:integrationInstance/item-settings/match

Offer one or more of your SKUs against items that already exist in the Walmart catalogue, matched by product identifier. Submitted as an MP_ITEM_MATCH feed; the response returns Walmart's feedId, which you can poll for per-item results.

Required scope: integrations:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

⚠ Replace mode re-keys existing offers. Walmart processes this feed in replace mode. If you already have an offer on the matched Walmart item under a different SKU, that offer is moved to the SKU you send here and the old SKU disappears from your Walmart catalogue (its listing, inventory and order history on Walmart now sit under the new SKU). Check for an existing offer on the item before you submit.

Request fields — items (array, required, 1–1000 entries). Each entry:

  • sku (string, required, max 50) — the seller SKU to create the offer under.
  • productIdType (string, required) — one of GTIN, UPC, ISBN, EAN.
  • productId (string, required, max 20) — the identifier of the existing Walmart item.
  • price (number, required, > 0) — the offer price in USD.
  • shippingWeight (number, required, > 0) — the shipping weight in pounds. Walmart needs it on every offer and it is never filled in for you.

Every offer is created in New condition.

Returns 422 when a field is missing or invalid (nothing is sent to Walmart). Requires the integrations.update permission and a Bearer token.

Request​

Responses​

OK