Skip to main content

(42) Combined listing change

1. Trigger scenario

This webhook is triggered when a combined listing is created, updated (the list of products in the combined listing changes), or deleted. Prerequisite: The "Product Basic" API scope is enabled in Partner Center. For more information, refer to Access Scope.

2. Data business parameters

Parameter nameData typeSampleDescription
typeint42The ID of this webhook topic, which is 42.
tts_notification_idstring"7327112393057371910"The ID of this webhook notification.
shop_idstring"7494049642642441621"The shop ID.
timestampint1644412885The time when this webhook is triggered. Unix timestamp.
dataobject
└ combined_listing_idstring"123456789"The combined listing ID.
└ products[]objectThe current list of products in this combined listing after the change.
└└ idstring"987654321"The product id.
└ statusstring"LIVE"The status of the combined listing. Possible values: * LIVE * SYSTEM_DEACTIVATED * SELLER_DEACTIVATED * DELETED Note: Only products in LIVE combined listings will appear on the product display page.
└ change_typestring"UPDATE"The type of change made to this combined listing. Possible values: * CREATE: The combined listing was created. * UPDATE: The combined listing was updated to add or remove products. * DELETE: The combined listing was deleted.
└ added_product_ids[]string["987654321"]The list of products that were newly added to the combined listing.
└ removed_product_ids[]string["987654322"]The list of products that were removed from the combined listing.

Event example

JSONWord Wrap

{
"type": 42,
"tts_notification_id": "7327112393057371910",
"shop_id": "7494049642642441621",
"timestamp": 1644412885,
"data": {
"combined_listing_id": "123456789",
"products": [
{
"id": "987654321"
},
{
"id": "987654322"
}
],
"status": "LIVE",
"change_type": "UPDATE",
"added_product_ids": [
"987654321"
],
"removed_product_ids": [
"987654333"
]
}
}