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.
integrations:writeGrant 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 ofGTIN,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
- 200
- 401
- 403
- 404
- 422
- 429
OK
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Entity
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.