WooCommerce webhook events
16 WooCommerce event types in 4 resources. 16 have sample payloads.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
coupon
coupon.created
verified from a captured delivery
coupon.created Coupon is created
Identified by x-wc-webhook-topic header
Resource coupon
{
"id": 17,
"code": "",
"amount": "10.00",
"status": "publish",
"date_created": "2023-03-25T16:22:37",
"date_created_gmt": "2023-03-25T16:22:37",
"date_modified": "2023-03-25T16:22:37",
"date_modified_gmt": "2023-03-25T16:22:37",
"discount_type": "percent",
"description": "",
"date_expires": "2023-03-31T00:00:00"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 17 |
status | string | publish |
amount | string | 10.00 Watch out Numeric string. |
Full schema: 35 fields.
Seen in a captured delivery
-
Content type
application/json -
Headers
user-agent,content-type,referer,x-wc-webhook-delivery-id,x-wc-webhook-event,x-wc-webhook-id,x-wc-webhook-resource,x-wc-webhook-signature,x-wc-webhook-source,x-wc-webhook-topic
coupon.updated
documented official schema
coupon.updated Coupon changes
Identified by x-wc-webhook-topic header
Resource coupon
{
"id": 719,
"code": "10off",
"amount": "5.00",
"date_created": "2017-03-21T15:23:00",
"date_created_gmt": "2017-03-21T18:23:00",
"date_modified": "2017-03-21T15:26:16",
"date_modified_gmt": "2017-03-21T18:26:16",
"discount_type": "percent",
"description": "",
"date_expires": null
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 719 |
amount | string | 5.00 Watch out Numeric string. |
Full schema: 34 fields.
From WooCommerce docs
-
Content type
application/json
coupon.deleted
verified from a captured delivery
coupon.deleted Coupon is moved to the trash
Identified by x-wc-webhook-topic header
Resource coupon
{
"id": 16
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 16 |
Full schema: 1 fields.
Seen in a captured delivery
-
Content type
application/json -
Headers
user-agent,content-type,referer,x-wc-webhook-delivery-id,x-wc-webhook-event,x-wc-webhook-id,x-wc-webhook-resource,x-wc-webhook-signature,x-wc-webhook-source,x-wc-webhook-topic
coupon.restored
verified from a captured delivery
coupon.restored Coupon is restored from the trash
Identified by x-wc-webhook-topic header
Resource coupon
{
"id": 16,
"code": "hook",
"amount": "5.00",
"status": "publish",
"date_created": "2023-03-25T16:04:36",
"date_created_gmt": "2023-03-25T16:04:36",
"date_modified": "2023-03-26T09:42:59",
"date_modified_gmt": "2023-03-26T09:42:59",
"discount_type": "percent",
"description": "",
"date_expires": "2023-03-31T00:00:00"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 16 |
status | string | publish |
amount | string | 5.00 Watch out Numeric string. |
Full schema: 39 fields.
Seen in a captured delivery
-
Content type
application/json -
Headers
user-agent,content-type,referer,x-wc-webhook-delivery-id,x-wc-webhook-event,x-wc-webhook-id,x-wc-webhook-resource,x-wc-webhook-signature,x-wc-webhook-source,x-wc-webhook-topic
customer
customer.created
documented official schema
customer.created Customer account is created
Identified by x-wc-webhook-topic header
Resource customer
{
"id": 25,
"date_created": "2017-03-21T16:09:28",
"date_created_gmt": "2017-03-21T19:09:28",
"date_modified": "2017-03-21T16:09:30",
"date_modified_gmt": "2017-03-21T19:09:30",
"email": "john.doe@example.com",
"first_name": "John",
"last_name": "Doe",
"role": "customer"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 25 |
Full schema: 42 fields.
From WooCommerce docs
-
Content type
application/json
customer.updated
documented official schema
customer.updated Customer account changes
Identified by x-wc-webhook-topic header
Resource customer
{
"id": 25,
"date_created": "2017-03-21T16:09:28",
"date_created_gmt": "2017-03-21T19:09:28",
"date_modified": "2017-03-21T16:12:28",
"date_modified_gmt": "2017-03-21T19:12:28",
"email": "john.doe@example.com",
"first_name": "James",
"last_name": "Doe",
"role": "customer"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 25 |
Full schema: 42 fields.
From WooCommerce docs
-
Content type
application/json
customer.deleted
documented official schema
customer.deleted User with the customer role is deleted
Identified by x-wc-webhook-topic header
Resource customer
{
"id": 25
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 25 |
Full schema: 1 fields.
From WooCommerce docs
-
Content type
application/json
order
order.created
documented official schema
order.created Order is created, excluding drafts
Identified by x-wc-webhook-topic header
Resource order
{
"id": 727,
"parent_id": 0,
"number": "727",
"order_key": "wc_order_58d2d042d1d",
"created_via": "rest-api",
"version": "3.0.0",
"status": "processing",
"currency": "USD",
"date_created": "2017-03-22T16:28:02",
"date_created_gmt": "2017-03-22T19:28:02",
"prices_include_tax": false,
"customer_id": 0
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 727 |
status | string | processing |
prices_include_tax | boolean | false |
customer_id | integer | 0 |
Full schema: 108 fields.
From WooCommerce docs
-
Content type
application/json
order.updated
documented official schema
order.updated Order changes, or a refund is added or removed
Identified by x-wc-webhook-topic header
Resource order
{
"id": 727,
"parent_id": 0,
"number": "727",
"order_key": "wc_order_58d2d042d1d",
"created_via": "rest-api",
"version": "3.0.0",
"status": "completed",
"currency": "USD",
"date_created": "2017-03-22T16:28:02",
"date_created_gmt": "2017-03-22T19:28:02",
"prices_include_tax": false,
"customer_id": 0
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 727 |
status | string | completed |
prices_include_tax | boolean | false |
customer_id | integer | 0 |
Full schema: 108 fields.
From WooCommerce docs
-
Content type
application/json
order.deleted
documented official schema
order.deleted Order is moved to the trash
Identified by x-wc-webhook-topic header
Resource order
{
"id": 727
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 727 |
Full schema: 1 fields.
From WooCommerce docs
-
Content type
application/json
order.restored
documented official schema
order.restored Order is restored from the trash
Identified by x-wc-webhook-topic header
Resource order
{
"id": 727,
"parent_id": 0,
"number": "727",
"order_key": "wc_order_58d2d042d1d",
"created_via": "rest-api",
"version": "3.0.0",
"status": "processing",
"currency": "USD",
"date_created": "2017-03-22T16:28:02",
"date_created_gmt": "2017-03-22T19:28:02",
"prices_include_tax": false,
"customer_id": 0
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 727 |
status | string | processing |
prices_include_tax | boolean | false |
customer_id | integer | 0 |
Full schema: 108 fields.
From WooCommerce docs
-
Content type
application/json
product
product.created
verified from a captured delivery
product.created Product or variation is created
Identified by x-wc-webhook-topic header
Resource product
{
"id": 18,
"name": "Perpemint",
"slug": "perpemint",
"permalink": "http://localhost/wordpress/product/perpemint/",
"date_created": "2023-03-26T09:29:39",
"date_created_gmt": "2023-03-26T09:29:39",
"date_modified": "2023-03-26T09:29:39",
"date_modified_gmt": "2023-03-26T09:29:39",
"type": "simple",
"status": "publish",
"featured": false,
"price": "150"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 18 |
status | string | publish |
type | string | simple |
price | string | 150 Watch out Numeric string. |
Full schema: 82 fields.
Seen in a captured delivery
-
Content type
application/json -
Headers
user-agent,content-type,referer,x-wc-webhook-delivery-id,x-wc-webhook-event,x-wc-webhook-id,x-wc-webhook-resource,x-wc-webhook-signature,x-wc-webhook-source,x-wc-webhook-topic
product.updated
verified from a captured delivery
product.updated Product or variation changes
Identified by x-wc-webhook-topic header
Resource product
{
"id": 18,
"name": "Perpemint",
"slug": "perpemint",
"permalink": "http://localhost/wordpress/product/perpemint/",
"date_created": "2023-03-26T09:29:39",
"date_created_gmt": "2023-03-26T09:29:39",
"date_modified": "2023-03-26T09:29:39",
"date_modified_gmt": "2023-03-26T09:29:39",
"type": "simple",
"status": "publish",
"featured": false,
"price": "150"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 18 |
status | string | publish |
type | string | simple |
price | string | 150 Watch out Numeric string. |
Full schema: 82 fields.
Seen in a captured delivery
-
Content type
application/json -
Headers
user-agent,content-type,referer,x-wc-webhook-delivery-id,x-wc-webhook-event,x-wc-webhook-id,x-wc-webhook-resource,x-wc-webhook-signature,x-wc-webhook-source,x-wc-webhook-topic
product.deleted
documented official schema
product.deleted Product is moved to the trash
Identified by x-wc-webhook-topic header
Resource product
{
"id": 794
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 794 |
Full schema: 1 fields.
From WooCommerce docs
-
Content type
application/json
product.restored
documented official schema
product.restored Product is restored from the trash
Identified by x-wc-webhook-topic header
Resource product
{
"id": 794,
"name": "Premium Quality",
"slug": "premium-quality-19",
"permalink": "https://example.com/product/premium-quality-19/",
"date_created": "2017-03-23T17:01:14",
"date_created_gmt": "2017-03-23T20:01:14",
"date_modified": "2017-03-23T17:01:14",
"date_modified_gmt": "2017-03-23T20:01:14",
"type": "simple",
"status": "publish",
"featured": false,
"price": "21.99"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 794 |
status | string | publish |
type | string | simple |
price | string | 21.99 Watch out Numeric string. |
Full schema: 89 fields.
From WooCommerce docs
-
Content type
application/json
product.published
documented official schema
product.published Product or variation moves to published status
Identified by x-wc-webhook-topic header
Resource product
{
"id": 794,
"name": "Premium Quality",
"slug": "premium-quality-19",
"permalink": "https://example.com/product/premium-quality-19/",
"date_created": "2017-03-23T17:01:14",
"date_created_gmt": "2017-03-23T20:01:14",
"date_modified": "2017-03-23T17:01:14",
"date_modified_gmt": "2017-03-23T20:01:14",
"type": "simple",
"status": "publish",
"featured": false,
"price": "21.99"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 794 |
status | string | publish |
type | string | simple |
price | string | 21.99 Watch out Numeric string. |
Full schema: 89 fields.
From WooCommerce docs
-
Content type
application/json
Route WooCommerce events by type.
Event Gateway receives every WooCommerce delivery and filters and routes it by event type, so each service gets only the events it handles.