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 is created

Identified by x-wc-webhook-topic header Resource coupon

woocommerce-coupon-created.json
{
  "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

Send example to Inspect → View as JSON

coupon.updated

documented official schema

Coupon changes

Identified by x-wc-webhook-topic header Resource coupon

woocommerce-coupon-updated.json
{
  "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

Send example to Inspect → View as JSON

coupon.deleted

verified from a captured delivery

Coupon is moved to the trash

Identified by x-wc-webhook-topic header Resource coupon

woocommerce-coupon-deleted.json
{
  "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

Send example to Inspect → View as JSON

coupon.restored

verified from a captured delivery

Coupon is restored from the trash

Identified by x-wc-webhook-topic header Resource coupon

woocommerce-coupon-restored.json
{
  "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

Send example to Inspect → View as JSON

customer

customer.created

documented official schema

Customer account is created

Identified by x-wc-webhook-topic header Resource customer

woocommerce-customer-created.json
{
  "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

Send example to Inspect → View as JSON

customer.updated

documented official schema

Customer account changes

Identified by x-wc-webhook-topic header Resource customer

woocommerce-customer-updated.json
{
  "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

Send example to Inspect → View as JSON

customer.deleted

documented official schema

User with the customer role is deleted

Identified by x-wc-webhook-topic header Resource customer

woocommerce-customer-deleted.json
{
  "id": 25
}

Key fields

Field Type Example
id integer 25

Full schema: 1 fields.

From WooCommerce docs

  • Content type application/json

Send example to Inspect → View as JSON

order

order.created

documented official schema

Order is created, excluding drafts

Identified by x-wc-webhook-topic header Resource order

woocommerce-order-created.json
{
  "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

Send example to Inspect → View as JSON

order.updated

documented official schema

Order changes, or a refund is added or removed

Identified by x-wc-webhook-topic header Resource order

woocommerce-order-updated.json
{
  "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

Send example to Inspect → View as JSON

order.deleted

documented official schema

Order is moved to the trash

Identified by x-wc-webhook-topic header Resource order

woocommerce-order-deleted.json
{
  "id": 727
}

Key fields

Field Type Example
id integer 727

Full schema: 1 fields.

From WooCommerce docs

  • Content type application/json

Send example to Inspect → View as JSON

order.restored

documented official schema

Order is restored from the trash

Identified by x-wc-webhook-topic header Resource order

woocommerce-order-restored.json
{
  "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

Send example to Inspect → View as JSON

product

product.created

verified from a captured delivery

Product or variation is created

Identified by x-wc-webhook-topic header Resource product

woocommerce-product-created.json
{
  "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

Send example to Inspect → View as JSON

product.updated

verified from a captured delivery

Product or variation changes

Identified by x-wc-webhook-topic header Resource product

woocommerce-product-updated.json
{
  "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

Send example to Inspect → View as JSON

product.deleted

documented official schema

Product is moved to the trash

Identified by x-wc-webhook-topic header Resource product

woocommerce-product-deleted.json
{
  "id": 794
}

Key fields

Field Type Example
id integer 794

Full schema: 1 fields.

From WooCommerce docs

  • Content type application/json

Send example to Inspect → View as JSON

product.restored

documented official schema

Product is restored from the trash

Identified by x-wc-webhook-topic header Resource product

woocommerce-product-restored.json
{
  "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

Send example to Inspect → View as JSON

product.published

documented official schema

Product or variation moves to published status

Identified by x-wc-webhook-topic header Resource product

woocommerce-product-published.json
{
  "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

Send example to Inspect → View as 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.

Not affiliated with WooCommerce. Facts are compiled from public sources and linked inline.