This webhook payload is used to notify clients when an existing product has been updated in Skulytics through the List Products event flow.
The payload follows the same structure as the List Products response for the matching product type. Supported product types include Appliances, Furniture, and Mattresses.
Payload Details
type: Specifies the type of event, here product_updated.
action_date: The date and time when the product update event was made, formatted as MM/DD/YYYY HH:MM:SS.
payload: An array that contains the full updated product object from Skulytics. The structure of the product object may vary depending on the product type.
Appliances — Product Updated
Event Sent
{
"type": "product_updated",
"action_date": "06/20/2026 02:01:59",
"payload": [
{
"product_id": 947,
"sku": "JVW5301SJSS",
"brand_sku": "JVW5301SJSS",
"short_sku": null,
"alternate_sku": null,
"replaced_sku": null,
"link": "https://www.geappliances.com/appliance/GE-30-Wall-Mount-Pyramid-Chimney-Hood-JVW5301SJSS",
"upc": "084691814399",
"color": {
"brand_color": "Stainless Steel"
},
"name": "30\" Wall-Mount Pyramid Chimney Hood",
"primary_image": "https://assets.skulytics.io/assets/images/JVW5301SJSS-105135904.webp",
"descriptions": {
"short_description": null,
"long_description": null
},
"product_type": "Appliances",
"attributes": {
"built_in": "Yes"
},
"relations": {
"color_relation": [
{
"sku": "JVW5301EJES",
"brand_sku": "JVW5301EJES",
"color": "Fingerprint Resistant Slate"
},
{
"sku": "JVW5301FJDS",
"brand_sku": "JVW5301FJDS",
"color": "Fingerprint Resistant Black Slate"
},
{
"sku": "JVW5301BJTS",
"brand_sku": "JVW5301BJTS",
"color": "Fingerprint Resistant Black Stainless"
}
],
"related_items": [
{
"product_id": "10049",
"sku": "JXCF72",
"brand_sku": "JXCF72",
"item_type": "Accessories"
},
{
"product_id": "12589",
"sku": "UXDC53SJSS",
"brand_sku": "UXDC53SJSS",
"item_type": "Accessories"
},
{
"product_id": "12602",
"sku": "UXRC70",
"brand_sku": "UXRC70",
"item_type": "Accessories"
},
{
"product_id": "12575",
"sku": "UXDC72SJSS",
"brand_sku": "UXDC72SJSS",
"item_type": "Accessories"
},
{
"product_id": "10000",
"sku": "JX10DC53SS",
"brand_sku": "JX10DC53SS",
"item_type": "Accessories"
},
{
"product_id": "113766",
"sku": "JXRC70",
"brand_sku": "JXRC70",
"item_type": "Accessories"
},
{
"product_id": "10053",
"sku": "JXDC72SS",
"brand_sku": "JXDC72SS",
"item_type": "Accessories"
},
{
"product_id": "102337",
"sku": "PM10X311",
"brand_sku": "PM10X311",
"item_type": "Accessories"
},
{
"product_id": "10116",
"sku": "WB02X24871",
"brand_sku": "WB02X24871",
"item_type": "Accessories"
},
{
"product_id": "10117",
"sku": "WB02X24872",
"brand_sku": "WB02X24872",
"item_type": "Accessories"
}
],
"recommended_packages": []
},
"filter": [
{
"field": "Energy Star Rated",
"value": "No"
},
{
"field": "Type",
"value": "Hood"
},
{
"field": "CFM",
"value": "300 - 400"
},
{
"field": "Voltage",
"value": "120 V"
},
{
"field": "Mounting Type",
"value": "Wall Mount"
},
{
"field": "Color",
"value": "Stainless Steel"
},
{
"field": "Style",
"value": "Chimney Style"
},
{
"field": "Ventilation",
"value": "Convertible"
},
{
"field": "Vent Hood Width",
"value": "21 - 30 Inch"
},
{
"field": "Features",
"value": "Auto Turn On"
},
{
"field": "Features",
"value": "Auto Turn On"
},
{
"field": "Features",
"value": "Built-in Lighting"
},
{
"field": "Features",
"value": "Built-in Lighting"
},
{
"field": "Features",
"value": "Auto Turn On"
},
{
"field": "Features",
"value": "Auto Turn On"
},
{
"field": "Blower Type",
"value": "Internal"
}
],
"brand": {
"brand_id": 17,
"brand_name": "GE",
"brand_slug": "ge",
"brand_image": "https://assets.skulytics.io/assets/brands/863774-ge.webp",
"brand_banner": "https://assets.skulytics.io/assets/brands/424160-ge-background.webp",
"brand_manufacturer": "GE",
"brand_blurb": null,
"brand_group": "GE",
"manual_brand": 0,
"multi_brand": 0
},
"selling_countries": [
{
"country_id": "1",
"country_name": "United States",
"country_code": "US"
}
],
"category": {
"category_id": 2,
"category_name": "Cooking",
"category_slug": "cooking",
"category_image": "https://assets.skulytics.io/assets/category/268030-cooking.webp"
},
"subcategory": {
"subcategory_id": 7,
"subcategory_name": "Vent Hoods",
"subcategory_slug": "vent-hoods",
"subcategory_image": "https://assets.skulytics.io/assets/subcategory/437483-vent-hoods.webp"
},
"detail_category": {
"detail_category_id": 37,
"detail_category_name": "Wall & Chimney Hoods",
"detail_category_slug": "wall-chimney-hoods",
"detail_category_image": "https://assets.skulytics.io/assets/detail-category/202610-wall-chimney-hoods.webp"
},
"date_added": "9/2/2021 6:02 AM",
"date_modified": "6/16/2026 6:04 AM"
}
],
"meta": {
"changed_attributes": [
"name",
"primary_image",
"descriptions.short_description",
"filter"
]
}
}
Furniture — Product Updated
Event Sent
{
"type": "product_updated",
"action_date": "06/20/2026 02:01:59",
"payload": [
{
"product_id": 1403832,
"sku": "AEL36DFBLK",
"brand_sku": "AEL36DF-BLK",
"short_sku": "AEL36DF-BLK",
"alternate_sku": null,
"replaced_sku": null,
"link": "https://www.mylibertyfurniture.com/products/512-BR-QPS/queen-poster-bed",
"upc": null,
"color": {
"brand_color": "Other",
"standardized_color": "Other"
},
"name": "Arden Road Queen Poster Bed",
"primary_image": "https://assets.skulytics.io/assets/images/AEL36DFBLK-63310457.webp",
"descriptions": {
"short_description": null,
"long_description": null
},
"product_type": "Furniture",
"attributes": {
"measurements": {
"width": "66 in.",
"depth": "19 in.",
"height": "76 in.",
"weight": "275 lbs."
},
"style": "Traditional",
"bed_size": null,
"rug_size": null,
"collections": "Arden Road",
"tags": [
"Liberty Furniture",
"Dressers",
"Brown",
"Satin Cherry"
],
"group": {
"group_id": null,
"group_name": null
},
"variations": {
"bed_size_variation": [
"Twin",
"King"
],
"rug_size_variation": [
"5 x 4",
"6 x 8"
],
"pillow_size_variation": [
"Twin",
"King"
],
"color_variation": [
"Yurman Pearl",
"Zebra Camel"
],
"image_variation": null
}
},
"relations": {
"color_relation": [],
"type_relation": [
{
"product_id": 1676394,
"sku": "5009400211010",
"brand_sku": "500940021-1010",
"type_name": "Profile & Feel",
"type_value": "14\" Firm"
},
{
"product_id": 1676406,
"sku": "5009400131010",
"brand_sku": "500940013-1010",
"type_name": "Profile & Feel",
"type_value": "16\" Plush Pillow Top"
}
],
"pieces_included": [],
"size_group": [
{
"sku": "5009463811060",
"brand_sku": "500946381-1060",
"value": "King"
},
{
"sku": "5009463811070",
"brand_sku": "500946381-1070",
"value": "Cal King"
}
],
"related_items": [
{
"product_id": 1647882,
"sku": "5009444611030",
"brand_sku": "500944461-1030",
"item_type": "Product"
},
{
"product_id": 1647883,
"sku": "5009444611050",
"brand_sku": "500944461-1050",
"item_type": "Product"
}
]
},
"filter": [],
"brand": {
"brand_id": 168,
"brand_name": "Liberty Furniture",
"brand_slug": "liberty-furniture",
"brand_image": "https://assets.skulytics.io/assets/brands/404446-liberty-furniture.webp",
"brand_banner": "https://assets.skulytics.io/assets/brands/570568-liberty-background.webp",
"brand_manufacturer": "Liberty Furniture",
"brand_group": null,
"brand_blurb": "Liberty Furniture is a top choice for consumers seeking quality, on-trend furniture that embodies honesty, pride, and originality. Since 1992, Liberty has been committed to hard work, fairness, and integrity—principles central to its success. Each piece is crafted with attention to detail, ensuring quality and style. Liberty Furniture’s exclusive distribution model partners only with authorized dealers. This ensures customers receive genuine products and exceptional service from knowledgeable retailers for a consistent shopping experience. Liberty Furniture offers diverse collections: stylish bedroom sets; versatile dining collections; entertainment units; home office solutions; unique occasional pieces; sophisticated upholstery options; durable outdoor furniture; and youth collections. Choosing Liberty Furniture means investing in excellence and timeless design that elevates your home's ambiance.",
"manual_brand": 0,
"multi_brand": 0
},
"selling_countries": [
{
"country_id": "1",
"country_name": "United States",
"country_code": "US"
}
],
"category": {
"category_id": 13,
"category_name": "Furniture",
"category_slug": "furniture",
"category_image": "https://assets.skulytics.io/assets/category/419077-furniture.webp"
},
"subcategory": {
"subcategory_id": 48,
"subcategory_name": "Bedroom",
"subcategory_slug": "bedroom",
"subcategory_image": "https://assets.skulytics.io/assets/subcategory/492684-bedroom.webp"
},
"detail_category": {
"detail_category_id": 225,
"detail_category_name": "Beds",
"detail_category_slug": "beds",
"detail_category_image": "https://assets.skulytics.io/assets/detail-category/190725-beds.webp"
},
"date_added": "12/23/2021 10:16 PM",
"date_modified": "10/28/2025 9:01 AM"
}
],
"meta": {
"changed_attributes": [
"name",
"color.brand_color",
"attributes.style",
"descriptions.long_description",
"filter"
]
}
}
Mattresses — Product Updated
Event Sent
{
"type": "product_updated",
"action_date": "06/20/2026 02:01:59",
"payload": [
{
"product_id": 1403832,
"sku": "AEL36DFBLK",
"brand_sku": "AEL36DF-BLK",
"short_sku": "AEL36DF-BLK",
"alternate_sku": null,
"replaced_sku": null,
"link": "https://www.mylibertyfurniture.com/products/512-BR-QPS/queen-poster-bed",
"upc": null,
"color": {
"brand_color": "Other",
"standardized_color": "Other"
},
"name": "Arden Road Queen Poster Bed",
"primary_image": "https://assets.skulytics.io/assets/images/AEL36DFBLK-63310457.webp",
"descriptions": {
"short_description": null,
"long_description": null
},
"product_type": "Mattresses",
"attributes": {
"measurements": {
"width": "66 in.",
"depth": "19 in.",
"height": "76 in.",
"weight": "275 lbs."
},
"mattress_size": null,
"collections": "Arden Road",
"comfort": "Arden Road",
"type": "Arden Road",
"tags": [
"Liberty Furniture",
"Dressers",
"Brown",
"Satin Cherry"
],
"group": {
"group_id": null,
"group_name": null
},
"variations": {
"mattress_size_variation": [],
"pillow_size_variation": [],
"color_variation": [],
"comfort_variation": [],
"type_variation": [],
"image_variation": null
}
},
"relations": {
"color_relation": [],
"type_relation": [
{
"product_id": 1676394,
"sku": "5009400211010",
"brand_sku": "500940021-1010",
"type_name": "Profile & Feel",
"type_value": "14\" Firm"
},
{
"product_id": 1676406,
"sku": "5009400131010",
"brand_sku": "500940013-1010",
"type_name": "Profile & Feel",
"type_value": "16\" Plush Pillow Top"
}
],
"pieces_included": [],
"size_group": [
{
"sku": "5009463811060",
"brand_sku": "500946381-1060",
"value": "King"
},
{
"sku": "5009463811070",
"brand_sku": "500946381-1070",
"value": "Cal King"
}
],
"related_items": [
{
"product_id": 1647882,
"sku": "5009444611030",
"brand_sku": "500944461-1030",
"item_type": "Product"
},
{
"product_id": 1647883,
"sku": "5009444611050",
"brand_sku": "500944461-1050",
"item_type": "Product"
}
]
},
"filter": [],
"brand": {
"brand_id": 168,
"brand_name": "Liberty Furniture",
"brand_slug": "liberty-furniture",
"brand_image": "https://assets.skulytics.io/assets/brands/404446-liberty-furniture.webp",
"brand_banner": "https://assets.skulytics.io/assets/brands/570568-liberty-background.webp",
"brand_manufacturer": "Liberty Furniture",
"brand_group": null,
"brand_blurb": "Liberty Furniture is a top choice for consumers seeking quality, on-trend furniture that embodies honesty, pride, and originality. Since 1992, Liberty has been committed to hard work, fairness, and integrity—principles central to its success. Each piece is crafted with attention to detail, ensuring quality and style. Liberty Furniture’s exclusive distribution model partners only with authorized dealers. This ensures customers receive genuine products and exceptional service from knowledgeable retailers for a consistent shopping experience. Liberty Furniture offers diverse collections: stylish bedroom sets; versatile dining collections; entertainment units; home office solutions; unique occasional pieces; sophisticated upholstery options; durable outdoor furniture; and youth collections. Choosing Liberty Furniture means investing in excellence and timeless design that elevates your home's ambiance.",
"manual_brand": 0,
"multi_brand": 0
},
"selling_countries": [
{
"country_id": "1",
"country_name": "United States",
"country_code": "US"
}
],
"category": {
"category_id": 13,
"category_name": "Furniture",
"category_slug": "furniture",
"category_image": "https://assets.skulytics.io/assets/category/419077-furniture.webp"
},
"subcategory": {
"subcategory_id": 48,
"subcategory_name": "Bedroom",
"subcategory_slug": "bedroom",
"subcategory_image": "https://assets.skulytics.io/assets/subcategory/492684-bedroom.webp"
},
"detail_category": {
"detail_category_id": 225,
"detail_category_name": "Beds",
"detail_category_slug": "beds",
"detail_category_image": "https://assets.skulytics.io/assets/detail-category/190725-beds.webp"
},
"date_added": "12/23/2021 10:16 PM",
"date_modified": "10/28/2025 9:01 AM"
}
],
"meta": {
"changed_attributes": [
"name",
"attributes.comfort",
"attributes.type",
"descriptions.short_description",
"filter"
]
}
}Payload Details
The Definitions of Each Data Point
| Name | Type | Definition |
|---|---|---|
| product_id | integer | Unique Skulytics product identifier. |
| sku | string | Normalized product identifier used by Skulytics, created from the manufacturer/brand SKU by removing whitespace and punctuation such as spaces, commas, and hyphens. |
| brand_sku | string | Original brand/manufacturer model number. |
| short_sku | string | Manufacturer-provided shortened SKU or model code for the product. |
| alternate_sku | string | Alternate or equivalent SKU for the product, if available. |
| replaced_sku | string | Previous SKU or model number that was replaced by this product, if available. |
| link | string | Official product page URL. |
| upc | var char | Standardized retail barcode identifier for the product. |
| name | string | Product display name or title. |
| primary_image | string | URL of the main product image. |
| descriptions | object | Description container for product marketing copy. |
| descriptions.short_description | string | Brief marketing summary of the product. |
| descriptions.long_description | string | Detailed marketing description of the product. |
| product_type | string | Product type discriminator. Expected values include Appliances, Furniture, or Mattresses. |
| color | object | Color information container. Fields may vary by product type/source. |
| color.brand_color | string | Brand-provided color label. |
| color.standardized_color | string | Normalized or standardized color label. |
| attributes | object | Product attribute container. Structure varies by product_type. |
| attributes.built_in | string | Indicates whether the product is built-in, typically Yes or No. |
| attributes.measurements | object | Measurement container with dimensions and weight. |
| attributes.measurements.width | string | Product width with unit, for example 66 in.. |
| attributes.measurements.depth | string | Product depth with unit, for example 19 in.. |
| attributes.measurements.height | string | Product height with unit, for example 76 in.. |
| attributes.measurements.weight | string | Product weight with unit, for example 275 lbs.. |
| attributes.style | string | Furniture style, for example Traditional. |
| attributes.bed_size | string | Bed size value, if applicable. |
| attributes.rug_size | string | Rug size value, if applicable. |
| attributes.mattress_size | string | Mattress size value, if applicable. |
| attributes.collections | string | Product collection name. |
| attributes.comfort | string | Comfort classification. |
| attributes.type | string | Mattress type or product type classification. |
| attributes.tags | array | Tags used for merchandising, filtering, or search. |
| attributes.group | object | Product group metadata. |
| attributes.group.group_id | integer | string | Group identifier. |
| attributes.group.group_name | string | Group display name. |
| attributes.variations | object | Available product variation options. |
| attributes.variations.bed_size_variation | array | Available bed size variation values. |
| attributes.variations.rug_size_variation | array | Available rug size variation values. |
| attributes.variations.mattress_size_variation | array | Available mattress size variation values. |
| attributes.variations.pillow_size_variation | array | Available pillow size variation values. |
| attributes.variations.color_variation | array | Available color variation values. |
| attributes.variations.comfort_variation | array | Available comfort variation values. |
| attributes.variations.type_variation | array | Available type variation values. |
| attributes.variations.image_variation | string | array | null | Image variation data, if available. |
| relations | object | Related product and variant relationship container. |
| relations.color_relation | array | Color variant products, if any. |
| relations.color_relation[].product_id | integer | Related product ID for the color variant. |
| relations.color_relation[].sku | string | Related Skulytics SKU for the color variant. |
| relations.color_relation[].brand_sku | string | Related original manufacturer model number for the color variant. |
| relations.color_relation[].color | string | Color label or value for the variant. |
| relations.type_relation | array | Type, profile, feel, or feature variant products. |
| relations.type_relation[].product_id | integer | Related product ID for the type variant. |
| relations.type_relation[].sku | string | Related Skulytics SKU for the type variant. |
| relations.type_relation[].brand_sku | string | Related original manufacturer model number for the type variant. |
| relations.type_relation[].type_name | string | Variant dimension or attribute name, for example Profile & Feel. |
| relations.type_relation[].type_value | string | Variant value, for example 14" Firm. |
| relations.pieces_included | array | Items included in a set or package. |
| relations.pieces_included[].product_id | integer | Included item product ID. |
| relations.pieces_included[].sku | string | Included item Skulytics SKU. |
| relations.pieces_included[].brand_sku | string | Included item original manufacturer model number. |
| relations.size_group | array | Size grouping options for related size variants. |
| relations.size_group[].product_id | integer | null | Related product ID for the size option, if available. |
| relations.size_group[].sku | string | Related Skulytics SKU for the size option. |
| relations.size_group[].brand_sku | string | Related original manufacturer model number for the size option. |
| relations.size_group[].value | string | Size label, for example King or Cal King. |
| relations.related_items | array | Related or cross-sell product items. |
| relations.related_items[].product_id | integer | Related product ID. |
| relations.related_items[].sku | string | Related Skulytics SKU. |
| relations.related_items[].brand_sku | string | Related original manufacturer model number. |
| relations.related_items[].item_type | string | Relationship item type, for example Product. |
| relations.related_items[].type | string | Relationship type, for example Product. |
| relations.recommended_packages | array | Recommended product packages or bundles. |
| relations.recommended_packages[].name | string | Package name, for example Package 1. |
| relations.recommended_packages[].sku_list | array | List of products included in the recommended package. |
| relations.recommended_packages[].sku_list[].product_id | integer | Product ID included in the package. |
| relations.recommended_packages[].sku_list[].sku | string | Skulytics SKU included in the package. |
| relations.recommended_packages[].sku_list[].detail_category | string | Detail category name for the packaged item. |
| filter | array | An object used to filter related records returned by the API. |
| filter.field | string | The relation field or attribute to filter by. |
| filter.value | string | The value that the selected field must match. |
| brand | object | Brand metadata container. |
| brand.brand_id | integer | Unique brand identifier. |
| brand.brand_name | string | Brand display name. |
| brand.brand_slug | string | URL-friendly brand identifier. |
| brand.brand_image | string | Brand logo image URL. |
| brand.brand_banner | string | Brand banner or hero image URL. |
| brand.brand_manufacturer | string | Manufacturer or parent company label. |
| brand.brand_blurb | string | Optional brand description or marketing blurb. |
| brand.brand_group | string | Optional brand group label. |
| brand.manual_brand | integer | Flag indicating manual brand handling, usually 0 or 1. |
| brand.multi_brand | integer | Flag indicating multi-brand mapping behavior, usually 0 or 1. |
| selling_countries | array | Countries where the product is sold or marketed. |
| selling_countries[].country_id | integer | Country identifier. |
| selling_countries[].country_name | string | Country name, for example United States. |
| selling_countries[].country_code | string | ISO country code, for example US. |
| category | object | Top-level category taxonomy container. |
| category.category_id | integer | Category ID. |
| category.category_name | string | Category name. |
| category.category_slug | string | Category slug. |
| category.category_image | string | Category image URL. |
| subcategory | object | Second-level category taxonomy container. |
| subcategory.subcategory_id | integer | Subcategory ID. |
| subcategory.subcategory_name | string | Subcategory name. |
| subcategory.subcategory_slug | string | Subcategory slug. |
| subcategory.subcategory_image | string | Subcategory image URL. |
| detail_category | object | Third-level category taxonomy container. |
| detail_category.detail_category_id | integer | Detail category ID. |
| detail_category.detail_category_name | string | Detail category name. |
| detail_category.detail_category_slug | string | Detail category slug. |
| detail_category.detail_category_image | string | Detail category image URL. |
| date_added | string | Date and time when the product was added, returned as a formatted API string. |
| date_modified | string | Date and time when the product was last updated, returned as a formatted API string. |
| changed_attributes | array | List of data fields that were changed in the product update event. |