Product Events
A comprehensive list of events that can activate webhooks for product changes, including creation, updates, and removals.
Events
| Event | Description |
|---|---|
product-created | Triggers when a new product is created. |
product-updated | Triggers when an existing product is updated. |
product-removed | Triggers when a product is removed. |
product-released | Triggers when a product is made available for sale. |
product-expired | Triggers when a product is disabled from being sold. |
product-stock-updated | Triggers when the stock of a product is updated. |
product-price-updated | Triggers when any of a product's pricing models is updated. |
Webhook Payload Examples
product-created
{
"event_id": "whev_o4wpo751jfvy859ko",
"event_type": "product-created",
"api_version": 2,
"endpoint_id": "5dcbcd22-c0e5-4003-8223-e367ce5eb8bf",
"object": "event",
"data": {
"product": {
"id": "91de2671-199a-459c-a50a-2ad126529a56",
"object": "product",
"name": "My Awesome Product",
"classification": "General",
"created": "2022-10-22 23:24:43 +0000",
"created_unix": 1666481083,
"price": 1200,
"currency": "EUR",
"gallery": [],
"in_stock": true,
"type": "physical_product",
"updated": "2022-10-22 23:38:04 +0000",
"updated_unix": 1666481884,
"on_sale": true,
"discount_allowed": true,
"hide_if_no_stock": true,
"shown": true,
"description": null,
"long_description": null,
"seo_description": null,
"seo_title": null,
"stock": 10,
"tax_calculation": "exclusive",
"has_variations": true,
"unlimited_stock": false,
"pricing_model": [
{
"id": "7a2457d5-f219-4332-b63b-4645cd4b80ae",
"object": "pricing_model",
"currency": "EUR",
"price": 1200,
"recommended_seller_price": 0,
"acquisition_price": 0
}
],
"custom_attributes": null,
"min_units": null,
"max_units": null,
"stock_limit_warning": null,
"allow_negative_stock": false,
"related_products": null,
"additional_information": {
"sample": false,
"release_date_unix": null,
"release_date": null,
"expiry_date_unix": null,
"expiry_date": null,
"new_from_unix": null,
"new_from": null,
"new_to_unix": null,
"new_to": null,
"exclude_from_feed": false,
"brand": null,
"model": null,
"asin": null,
"upc": null,
"mpn": null,
"isbn": null,
"ean": null,
"gtin": null,
"sku": null,
"hscode": null
},
"languages": {
"en": {
"title": "My Awesome Product"
}
},
"packs": [
{
"id": "1ec6e373-378c-4655-9d35-23056d753558",
"label": "Pack of 10",
"multiples": false,
"stock": 10,
"variants": [
{
"id": "854e9ede-4e47-4838-924f-8dce1f80b2d8",
"stock": 10
}
]
}
],
"weight": null,
"dimensions": {
"length": null,
"width": null,
"height": null
},
"variations": {
"delta_pricing": true,
"options": [
{
"label": {
"de": "Größe",
"en": "Size"
},
"type": "dropdown-list",
"values": [
{
"de": "Klein",
"en": "Large"
}
]
}
],
"variants": [
{
"allow_negative_stock": false,
"dimensions": {
"height": 1,
"length": 1,
"width": 1
},
"gallery": [],
"hide_if_no_stock": true,
"id": "854e9ede-4e47-4838-924f-8dce1f80b2d8",
"options": {
"en": {
"Size": "Large"
},
"de": {
"Größe": "Klein"
}
},
"pricing_model": [
{
"id": "78805515-8c2b-4fef-b79a-4fe81cd021f2",
"object": "pricing_model",
"currency": "EUR",
"price": 10000,
"recommended_seller_price": 0,
"acquisition_price": 0
}
],
"shown": true,
"sku": "SKUNUMBER",
"stock": 10,
"stock_breakdown": [
{
"areas_served": [
"au",
"ar"
],
"stock": 10,
"warehouse": "68f5d2ca-0e90-4ed6-9c08-0f0c597b643d"
}
],
"unlimited_stock": false
}
]
},
"is_moss_product": false
}
}
}product-updated
{
"event_id": "whev_4vke68wd1u5y2djr6",
"event_type": "product-updated",
"api_version": 2,
"object": "event",
"data": {
"product": {
"id": "37346356-4f0b-456e-816d-8b521047cef9",
"object": "product",
"name": "Leather Sofa (100% Leather & 100% Cotton)",
"classification": "Business & Industrial",
"created": "2022-11-02 10:34:46 +0000",
"created_unix": 1667385286,
"price": 10000,
"currency": "EUR",
"gallery": [
"https://pub.tamio.com/1123-zCjqOMtnH4qOG3k5mn8AdA4GT/1593707805-madrone-leather-sofa-arhaus-1593707782.jpg"
],
"in_stock": true,
"type": "physical_product",
"updated": "2022-11-02 15:27:33 +0000",
"updated_unix": 1667402853,
"on_sale": true,
"discount_allowed": true,
"hide_if_no_stock": false,
"shown": false,
"description": "Our designer leather sofas are simple and comfortable, elegant and inviting. ",
"long_description": null,
"seo_description": null,
"seo_title": null,
"stock": 17,
"tax_calculation": "exclusive",
"has_variations": true,
"unlimited_stock": false,
"pricing_model": [
{
"id": "9156d0b0-7740-46fd-9dd8-6946ab1ac23d",
"object": "pricing_model",
"currency": "EUR",
"price": 10000,
"recommended_seller_price": 0,
"acquisition_price": 0
},
{
"id": "30f01dad-7d9f-41b8-80d3-c757d958a1ac",
"object": "pricing_model",
"currency": "GBP",
"price": 3200,
"recommended_seller_price": 0,
"acquisition_price": 0
}
],
"custom_attributes": [],
"min_units": null,
"max_units": null,
"related_products": null,
"stock_limit_warning": null,
"allow_negative_stock": false,
"additional_information": {
"sample": false,
"release_date_unix": null,
"release_date": null,
"expiry_date_unix": null,
"expiry_date": null,
"new_from_unix": null,
"new_from": null,
"new_to_unix": null,
"new_to": null,
"exclude_from_feed": false,
"brand": null,
"model": null,
"asin": null,
"upc": null,
"mpn": null,
"isbn": null,
"ean": "00751546987452",
"gtin": null,
"sku": null,
"hscode": null
},
"languages": {
"en": {
"title": "Leather Sofa (100% Leather & 100% Cotton)",
"seo_title": null,
"description": "Our designer leather sofas are simple and comfortable, elegant and inviting. ",
"seo_description": null,
"long_description": null
}
},
"packs": [],
"weight": null,
"dimensions": {
"length": null,
"width": null,
"height": null
},
"variations": {
"delta_pricing": true,
"options": [
{
"label": {
"en": "Color"
},
"type": "dropdown-list",
"values": [
{
"en": "Brown"
},
{
"en": "Black"
}
]
}
],
"variants": [
{
"allow_negative_stock": false,
"dimensions": null,
"gallery": [],
"hide_if_no_stock": false,
"id": "0a88244a-4403-4eae-8577-b63620e72a98",
"options": {
"en": {
"Color": "Brown"
}
},
"pricing_model": [
{
"currency": "EUR",
"price": 0
},
{
"currency": "GBP",
"price": 0
}
],
"shown": true,
"sku": "SKU",
"stock": 11,
"stock_breakdown": [
{
"areas_served": [
"europe"
],
"stock": 11,
"warehouse": "d9ad19da-4c96-406f-8cb5-6d6b9c019647"
}
],
"unlimited_stock": false,
"weight": null
},
{
"allow_negative_stock": false,
"dimensions": null,
"gallery": [],
"hide_if_no_stock": false,
"id": "f0a806c7-995a-4216-a73e-63c400862e4a",
"options": {
"en": {
"Color": "Black"
}
},
"pricing_model": [
{
"currency": "EUR",
"price": 0
},
{
"currency": "GBP",
"price": 0
}
],
"shown": true,
"sku": "SKU",
"stock": 6,
"stock_breakdown": [
{
"areas_served": [
"europe"
],
"stock": 6,
"warehouse": "d9ad19da-4c96-406f-8cb5-6d6b9c019647"
}
],
"unlimited_stock": false,
"weight": null
}
]
},
"is_moss_product": false
},
"changes": [
"name",
"languages"
]
},
"endpoint_id": "5dcbcd22-c0e5-4003-8223-e367ce5eb8bf"
}product-removed
{
"event_id": "whev_kv28w431nh7rw9d2r",
"event_type": "product-removed",
"api_version": 2,
"object": "event",
"endpoint_id": "5dcbcd22-c0e5-4003-8223-e367ce5eb8bf",
"data": {
"product": {
"id": "c8006b68-6619-4b3f-844c-7025ffaa5b3b"
}
}
}product-price-updated
{
"event_id": "whev_4moed71qc5y28472",
"event_type": "product-price-updated",
"api_version": 2,
"object": "event",
"data": {
"product": {
"id": "5b361fc5-c402-4a90-bdd0-7ef049601a0c",
"object": "product",
"name": "Digital Product",
"classification": "eBooks",
"created": "2022-11-02 14:36:28 +0000",
"created_unix": 1667399788,
"price": 1000,
"currency": "EUR",
"gallery": [],
"in_stock": true,
"type": "digital_product",
"updated": "2022-11-03 01:20:18 +0000",
"updated_unix": 1667438418,
"on_sale": true,
"discount_allowed": true,
"hide_if_no_stock": true,
"shown": false,
"description": null,
"long_description": null,
"seo_description": null,
"seo_title": null,
"stock": null,
"tax_calculation": "exclusive",
"has_variations": false,
"unlimited_stock": true,
"pricing_model": [
{
"id": "fb48c3b4-aabf-42df-8cda-c4886ada1af2",
"object": "pricing_model",
"currency": "EUR",
"price": 1000,
"recommended_seller_price": 100,
"acquisition_price": 200
},
{
"id": "d3f2cf07-7928-49e0-beff-7b1a0eb0144e",
"object": "pricing_model",
"currency": "GBP",
"price": 10000,
"recommended_seller_price": 300,
"acquisition_price": 400
}
],
"custom_attributes": [],
"min_units": 11,
"max_units": 22,
"related_products": null,
"stock_limit_warning": null,
"allow_negative_stock": false,
"additional_information": {
"sample": null,
"release_date_unix": null,
"release_date": null,
"expiry_date_unix": null,
"expiry_date": null,
"new_from_unix": null,
"new_from": null,
"new_to_unix": null,
"new_to": null,
"exclude_from_feed": false
},
"languages": {
"en": {
"title": "Digital Product",
"seo_title": null,
"description": null,
"seo_description": null,
"long_description": null
}
},
"number_of_downloads": 69,
"digital_files": [],
"delivery_type": "url",
"license_type": "autogenerated",
"licenses": [],
"delivery_url": "https://google.com",
"is_moss_product": true
},
"changes": {
"old_pricing_models": [
{
"id": "fb48c3b4-aabf-42df-8cda-c4886ada1af2",
"object": "pricing_model",
"currency": "EUR",
"price": 10000,
"recommended_seller_price": 100,
"acquisition_price": 200
},
{
"id": "d3f2cf07-7928-49e0-beff-7b1a0eb0144e",
"object": "pricing_model",
"currency": "GBP",
"price": 10000,
"recommended_seller_price": 300,
"acquisition_price": 400
}
],
"new_pricing_models": [
{
"id": "fb48c3b4-aabf-42df-8cda-c4886ada1af2",
"object": "pricing_model",
"currency": "EUR",
"price": 1000,
"recommended_seller_price": 100,
"acquisition_price": 200
},
{
"id": "d3f2cf07-7928-49e0-beff-7b1a0eb0144e",
"object": "pricing_model",
"currency": "GBP",
"price": 10000,
"recommended_seller_price": 300,
"acquisition_price": 400
}
]
}
},
"endpoint_id": "5dcbcd22-c0e5-4003-8223-e367ce5eb8bf"
}product-stock-updated
{
"event_id": "whev_nmkxwqm99u2po6o7k",
"event_type": "product-stock-updated",
"api_version": 2,
"object": "event",
"data": {
"product": {
"id": "5b361fc5-c402-4a90-bdd0-7ef049601a0c",
"object": "product",
"name": "Digital Product",
"classification": "eBooks",
"created": "2022-11-02 14:36:28 +0000",
"created_unix": 1667399788,
"price": 10000,
"currency": "EUR",
"gallery": [],
"in_stock": true,
"type": "digital_product",
"updated": "2022-11-02 23:59:12 +0000",
"updated_unix": 1667433552,
"on_sale": true,
"discount_allowed": true,
"hide_if_no_stock": true,
"shown": false,
"description": null,
"long_description": null,
"seo_description": null,
"seo_title": null,
"stock": 21,
"tax_calculation": "exclusive",
"has_variations": false,
"unlimited_stock": false,
"pricing_model": [
{
"id": "fb48c3b4-aabf-42df-8cda-c4886ada1af2",
"object": "pricing_model",
"currency": "EUR",
"price": 10000,
"recommended_seller_price": 100,
"acquisition_price": 200
},
{
"id": "d3f2cf07-7928-49e0-beff-7b1a0eb0144e",
"object": "pricing_model",
"currency": "GBP",
"price": 10000,
"recommended_seller_price": 300,
"acquisition_price": 400
}
],
"custom_attributes": [],
"min_units": 11,
"max_units": 22,
"related_products": null,
"stock_limit_warning": null,
"allow_negative_stock": false,
"additional_information": {
"sample": null,
"release_date_unix": null,
"release_date": null,
"expiry_date_unix": null,
"expiry_date": null,
"new_from_unix": null,
"new_from": null,
"new_to_unix": null,
"new_to": null,
"exclude_from_feed": false
},
"languages": {
"en": {
"title": "Digital Product",
"seo_title": null,
"description": null,
"seo_description": null,
"long_description": null
}
},
"number_of_downloads": 69,
"digital_files": [],
"delivery_type": "url",
"license_type": "autogenerated",
"licenses": [],
"delivery_url": "https://google.com",
"is_moss_product": true
},
"changes": {
"old_stock": "unlimited",
"new_stock": 21
}
},
"endpoint_id": "5dcbcd22-c0e5-4003-8223-e367ce5eb8bf"
}product-released
{
"event_id": "whev_4vze89gwys5y2y599",
"event_type": "product-released",
"api_version": 2,
"object": "event",
"data": {
"product": {
"id": "5b361fc5-c402-4a90-bdd0-7ef049601a0c",
"object": "product",
"name": "Digital Product",
"classification": "eBooks",
"created": "2022-11-02 14:36:28 +0000",
"created_unix": 1667399788,
"price": 2662,
"currency": "EUR",
"gallery": [],
"in_stock": true,
"type": "digital_product",
"updated": "2022-11-03 19:34:37 +0000",
"updated_unix": 1667504077,
"on_sale": true,
"discount_allowed": false,
"hide_if_no_stock": true,
"shown": true,
"description": null,
"long_description": null,
"seo_description": null,
"seo_title": null,
"stock": null,
"tax_calculation": "exclusive",
"has_variations": false,
"unlimited_stock": true,
"pricing_model": [
{
"id": "fb48c3b4-aabf-42df-8cda-c4886ada1af2",
"object": "pricing_model",
"currency": "EUR",
"price": 2662,
"recommended_seller_price": 100
},
{
"id": "d3f2cf07-7928-49e0-beff-7b1a0eb0144e",
"object": "pricing_model",
"currency": "GBP",
"price": 14448,
"recommended_seller_price": 300
}
],
"custom_attributes": [],
"min_units": 11,
"max_units": 22,
"related_products": null,
"stock_limit_warning": null,
"allow_negative_stock": false,
"additional_information": {
"sample": null,
"release_date_unix": null,
"release_date": null,
"expiry_date_unix": null,
"expiry_date": null,
"new_from_unix": null,
"new_from": null,
"new_to_unix": null,
"new_to": null,
"exclude_from_feed": false
},
"languages": {
"en": {
"title": "Digital Product",
"seo_title": null,
"description": null,
"seo_description": null,
"long_description": null
}
},
"number_of_downloads": 69,
"digital_files": [],
"delivery_type": "url",
"license_type": "autogenerated",
"licenses": [],
"delivery_url": "https://google.com",
"is_moss_product": true
}
},
"endpoint_id": "5dcbcd22-c0e5-4003-8223-e367ce5eb8bf"
}product-expired
{
"event_id": "whev_ngdky5vpt2pop2rd",
"event_type": "product-expired",
"api_version": 2,
"object": "event",
"data": {
"product": {
"id": "5b361fc5-c402-4a90-bdd0-7ef049601a0c",
"object": "product",
"name": "Digital Product",
"classification": "eBooks",
"created": "2022-11-02 14:36:28 +0000",
"created_unix": 1667399788,
"price": 2662,
"currency": "EUR",
"gallery": [],
"in_stock": true,
"type": "digital_product",
"updated": "2022-11-03 19:31:02 +0000",
"updated_unix": 1667503862,
"on_sale": false,
"discount_allowed": true,
"hide_if_no_stock": true,
"shown": false,
"description": null,
"long_description": null,
"seo_description": null,
"seo_title": null,
"stock": null,
"tax_calculation": "exclusive",
"has_variations": false,
"unlimited_stock": true,
"pricing_model": [
{
"id": "fb48c3b4-aabf-42df-8cda-c4886ada1af2",
"object": "pricing_model",
"currency": "EUR",
"price": 2662,
"recommended_seller_price": 100
},
{
"id": "d3f2cf07-7928-49e0-beff-7b1a0eb0144e",
"object": "pricing_model",
"currency": "GBP",
"price": 14448,
"recommended_seller_price": 300
}
],
"custom_attributes": [],
"min_units": 11,
"max_units": 22,
"related_products": null,
"stock_limit_warning": null,
"allow_negative_stock": false,
"additional_information": {
"sample": null,
"release_date_unix": null,
"release_date": null,
"expiry_date_unix": null,
"expiry_date": null,
"new_from_unix": null,
"new_from": null,
"new_to_unix": null,
"new_to": null,
"exclude_from_feed": true
},
"languages": {
"en": {
"title": "Digital Product",
"seo_title": null,
"description": null,
"seo_description": null,
"long_description": null
}
},
"number_of_downloads": 69,
"digital_files": [],
"delivery_type": "url",
"license_type": "autogenerated",
"licenses": [],
"delivery_url": "https://google.com",
"is_moss_product": true
}
},
"endpoint_id": "5dcbcd22-c0e5-4003-8223-e367ce5eb8bf"
}