Publish a catalog

post

https://example.com/v1/catalog

This request initiates an asynchronous process that creates or updates a catalog. This request operates on both catalog listings and dynamic attributes like price and inventory availability.

A successful response provides a reference_id for tracking purposes. Specify the reference_id value as a path parameter to the Verification request.

If requests exceed the maximum allowed, the server returns status code 429 - Too Many Requests (RFC 6585).

If the Hub system experiences a fault during processing, no changes are made. This measure ensures data consistency.

Body Params

catalogue_items

array of objects

required

catalogue_items*

upload_type

string

required

The type of the upload. This must be one of the following values.

S. No	Upload Type	Description
1	"CATALOG_UPLOAD"	Basic catalog information including item name, categories, and so on.
2	"ITEM_PRICE_INVENTORY_UPLOAD"	Dynamic attributes like price, item availability, and marketplaces.

Headers

WM_CONSUMER.ID

string

required

The Walmart consumer identifier (ID) of the tenant. The tenant must submit this ID in the header of every request.

Example:

"2d6cf199-9b07-4350-bb2b9-0db3c2"

Response

200OK