JSON API – PUT Update Walmart Listings

Overview

This endpoint updates Walmart listing configurations in Feedvisor using a JSON API request.

The API allows sending a batch of up to 1000 items per request.

Only persistable fields can be updated.
Fields marked as read-only in the GET endpoint cannot be updated through this API.

---

Endpoint

Method

PUT

URL

<Post-authentication Base URL>/external/{accountId}/v2/listings

---

Path Parameters

Parameter	Type	Required	Description
accountId	integer	Yes	Account id as Int

---

Headers

Authorization: Bearer <access token>

Optional logging header:

user-name: "myScript"

---

Request Body

The request body must contain an array of listing objects.

Maximum items per request:

1000

---

Mandatory Identification Fields

The following fields must be provided for each listing update.

Parameter	Type	Required	Description
sku	String	Yes	Seller SKU
itemId	String	Yes	Walmart Item ID

---

Writable Fields

The following fields are persistable and supported for updates.

Field	Type	Optional
brand	String	Yes
repricerStrategy	String	Yes
repriced	Boolean	Yes
floorPrice	Double	Yes
ceilingPrice	Double	Yes
repricingTargetOosd	Double	Yes
repricingTargetVelocity	Double	Yes
repricerMethod	String	Yes
fixedPrice	Double	Yes
referenceAccountId	String	Yes
referenceSKU	String	Yes
referenceASIN	String	Yes
referenceFulfillmentChannel	String	Yes
referencePriceChange	Double	Yes
cohort	String	Yes
vat	Double	Yes
shippingCost	Double	Yes
markup	Double	Yes
additionalSellingCosts	Double	Yes
comment	String	Yes
cost	Double	Yes
isbn	String	Yes
ean	String	Yes
mpn	String	Yes
vendorName	String	Yes
vendorPartNumber	String	Yes
leadTime	Double	Yes
unitsInPacks	Integer	Yes
minQuantityForOrder	Integer	Yes
parentSKU	String	Yes
daysOfCoverage	Integer	Yes
isReplenishable	Boolean	Yes
warehouseInventory	Integer	Yes

---

Read-Only Fields

The following fields are returned by the API but cannot be updated using this endpoint.

Field

buyBoxEligible

buyBoxItemPrice

buyBoxShippingPrice

currency

fulfillmentType

gtin

itemPageUrl

lifecycleStatus

maximumSellerAllowedPrice

minimumSellerAllowedPrice

msrp

offerEndDate

offerStartDate

price

primaryCategoryPath

primaryImageUrl

primaryVariant

productCategory

productName

productTaxCode

publishStatus

reviewsCount

searchable

shelfName

shipMethods

shippingWeight

shippingWeightUnit

statusChangeReason

upc

variantGroupId

variantGroupingAttributes

variantGroupingValues

wfsSalesRestriction

wpid

inventoryAvailToSellQuantity

wfsAvailableUnits

condition

dependentPriceCalculationType

fulfillmentChannel

quantity

---

Example Request

PUT /external/{accountId}/v2/listings

Body

[
  {
    "sku": "WM-ITEM-10001",
    "itemId": "1234567890",
    "cost": 12.45,
    "brand": "Example Brand",
    "vendorName": "Example Vendor",
    "floorPrice": 18.50,
    "ceilingPrice": 29.99,
    "warehouseInventory": 120
  }
]

---

Example Response

{
  "successMessage": "UPDATE_PRODUCT_CONFIGURATION_SUCCESS"
}

---

Notes

Batch Size

A single request may include up to:

1000 listings

---

Writable vs Read-Only

Fields marked as writable correspond to fields where:

persistable = TRUE

Fields marked as read-only correspond to fields where:

persistable = FALSE

These fields may appear in API responses but cannot be updated through the PUT endpoint.