Assortment recommendations notification

Assortment recommendations notification informs you when a new personalized assortment recommendation set is generated for a seller. When a set is published, Walmart sends a JSON payload to your destination URL. The recommendationContext.recommendationType field indicates the type of recommendation set available:

ASSORTMENT_GROWTH_NEW_RECOMMENDATIONS indicates a new general recommendation set based on marketplace demand and seller relevance. Use this event to prompt sellers to review and add high-demand items to their catalog.
ASSORTMENT_GROWTH_NEW_PARITY_RECOMMENDATIONS indicates a curated, parity-focused recommendation set for items the seller does not currently offer on Walmart. Use this event to identify assortment gaps and prioritize listings that expand selection.

Use these events to alert users, deep link to Seller Center, and retrieve recommendations through the Assortment Growth APIs.

Event metadata

Event type: ASSORTMENT_GROWTH_RECOMMENDATIONS
Event version: V1
Resource name: SELLER

Response parameters

Applies to both recommendation types: ASSORTMENT_GROWTH_NEW_RECOMMENDATIONS and ASSORTMENT_GROWTH_NEW_PARITY_RECOMMENDATIONS.

Name	Description	Type
source	Metadata about the event.	Object
eventType	Event type for this notification. Example: `ASSORTMENT_GROWTH_RECOMMENDATIONS`. Appears in `source`.	String
eventTime	Timestamp when the event was generated. ISO 8601 UTC. Appears in `source`.	String
eventId	Unique identifier for the event delivery. Use as an idempotency key. Appears in `source`.	String
payload	Event-specific details.	Object
seller	Seller context for the recommendation set. Appears in `payload`.	Object
sellerId	Seller identifier. Appears in `seller`.	String
marketplace	Marketplace name. Example: `Walmart`. Appears in `seller`.	String
recommendationContext	Recommendation set context and time window. Appears in `payload`.	Object
recommendationSetId	Identifier for the recommendation set. Appears in `recommendationContext`.	String
recommendationType	Type of recommendation set. See Supported recommendation types. Appears in `recommendationContext`.	String (enum)
periodStart	Start date covered by the recommendation set. Format: `YYYY-MM-DD`. Appears in `recommendationContext`.	String
periodEnd	End date covered by the recommendation set. Format: `YYYY-MM-DD`. Appears in `recommendationContext`.	String
links	Deep links to UI and API resources. Appears in `payload`.	Object
ui	Seller Center URL that opens the recommendations experience. Appears in `links`.	String (URL)
api	Developer portal URL for the recommendations API reference. Appears in `links`.	String (URL)
message	Human-readable message content for this notification. Appears in `payload`.	Object
key	Message key that identifies the notification. Appears in `message`.	String
desc	Message description shown to users or logged by systems. Appears in `message`.	String
partnerId	Partner identifier associated with the seller account. Appears in `payload`.	String
partnerName	Partner display name. Appears in `payload`.	String

Supported recommendation types (`recommendationType`)

Value	When it occurs	Typical use
ASSORTMENT_GROWTH_NEW_RECOMMENDATIONS	A new personalized recommendation set is published.	Notify users and pull the latest recommendations through the API.
ASSORTMENT_GROWTH_NEW_PARITY_RECOMMENDATIONS	A new parity-focused recommendation set is published.	Notify users and pull parity recommendations through the API.

Applies to all recommendation types

Use source.eventId as an idempotency key to safely de-duplicate deliveries.
Parse timestamps as indicated: source.eventTime is ISO 8601 UTC; periodStart and periodEnd are dates in YYYY-MM-DD.
Recommendation types may expand over time. Ignore unrecognized fields to keep your integration forward-compatible.

Sample payloads by recommendation type

ASSORTMENT_GROWTH_NEW_RECOMMENDATIONS

{ "source": { "eventType": "ASSORTMENT_GROWTH_RECOMMENDATIONS", "eventTime": "2021-03-31T06:39:54.726Z", "eventId": "e734a060-91eb-11eb-8024-dbd12dd659ed" }, "payload": { "seller": { "sellerId": "seller_12345", "marketplace": "Walmart" }, "recommendationContext": { "recommendationSetId": "recset_2026_01", "recommendationType": "ASSORTMENT_GROWTH_NEW_RECOMMENDATIONS", "periodStart": "2025-12-01", "periodEnd": "2025-12-31" }, "links": { "ui": "https://seller.walmart.com/growth/assortment-growth/recommendations?newrecommendation=true", "api": "https://developer.walmart.com/us-marketplace/reference/getassortmentrecommendations-1" }, "message": { "key": "ASSORTMENT_GROWTH_NEW_RECOMMENDATIONS_AVAILABLE", "desc": "New personalized assortment recommendations are live. Use the Assortment Growth APIs to discover and add high-demand items to your catalog." }, "partnerId" : "partnerId_12345", "partnerName" : "testpartnerName_12345", "sellerId" : "seller_12345" }
}

ASSORTMENT_GROWTH_NEW_PARITY_RECOMMENDATIONS

{ "source": { "eventType": "ASSORTMENT_GROWTH_RECOMMENDATIONS", "eventTime": "2021-03-31T06:39:54.726Z", "eventId": "e734a060-91eb-8024-dbd12dd659ed" }, "payload": { "seller": { "sellerId": "seller_12345", "marketplace": "Walmart" }, "recommendationContext": { "recommendationSetId": "recset_2026_01", "recommendationType": "ASSORTMENT_GROWTH_NEW_PARITY_RECOMMENDATIONS", "periodStart": "2025-12-01", "periodEnd": "2025-12-31" }, "links": { "ui": "https://seller.walmart.com/growth/assortment-growth/recommendations?newrecommendation=true", "api": "https://developer.walmart.com/us-marketplace/reference/getassortmentrecommendations-1" }, "message": { "key": "ASSORTMENT_GROWTH_NEW_PARITY_RECOMMENDATIONS_AVAILABLE", "desc": "New personalized assortment recommendations are live for items not sold in Walmart. Use the Assortment Growth APIs to discover and add high-demand items to your catalog." }, "partnerId" : "partnerId_12345", "partnerName" : "testpartnerName_12345", "sellerId" : "seller_12345" }
}

Updated about 18 hours ago