# WooCommerce webhook events

Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/woocommerce/mcp-events).

Agent skill: `npx skills add hookdeck/webhook-skills --skill woocommerce-webhooks` ([details](https://hookdeck.com/webhooks/woocommerce/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [WooCommerce's official docs](https://raw.githubusercontent.com/woocommerce/woocommerce-rest-api-docs/trunk/source/includes/wp-api-v3/_webhooks.md).

[Overview](https://hookdeck.com/webhooks/woocommerce) · [Webhook events (16)](https://hookdeck.com/webhooks/woocommerce/events) · [MCP events](https://hookdeck.com/webhooks/woocommerce/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/woocommerce/verify) · [Production guide](https://hookdeck.com/webhooks/woocommerce/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/woocommerce/skill)

## coupon

### coupon.created

Confidence: verified · Schema: from a captured delivery

Coupon is created

Identified by: x-wc-webhook-topic header · Object: `coupon`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/woocommerce/events/coupon-created.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `17` |
| `status` | string | `publish` |
| `amount` | string | `10.00` Watch out: Numeric string. |

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`

[View as JSON](https://hookdeck.com/webhooks/woocommerce/events/coupon-created.json)

### coupon.updated

Confidence: documented · Schema: official schema

Coupon changes

Identified by: x-wc-webhook-topic header · Object: `coupon`

```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
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/woocommerce/events/coupon-updated.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `719` |
| `amount` | string | `5.00` Watch out: Numeric string. |

From WooCommerce docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/woocommerce/events/coupon-updated.json)

### coupon.deleted

Confidence: verified · Schema: from a captured delivery

Coupon is moved to the trash

Identified by: x-wc-webhook-topic header · Object: `coupon`

```json
{
  "id": 16
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | integer | `16` |

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`

[View as JSON](https://hookdeck.com/webhooks/woocommerce/events/coupon-deleted.json)

### coupon.restored

Confidence: verified · Schema: from a captured delivery

Coupon is restored from the trash

Identified by: x-wc-webhook-topic header · Object: `coupon`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/woocommerce/events/coupon-restored.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `16` |
| `status` | string | `publish` |
| `amount` | string | `5.00` Watch out: Numeric string. |

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`

[View as JSON](https://hookdeck.com/webhooks/woocommerce/events/coupon-restored.json)

## customer

### customer.created

Confidence: documented · Schema: official schema

Customer account is created

Identified by: x-wc-webhook-topic header · Object: `customer`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/woocommerce/events/customer-created.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `25` |

From WooCommerce docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/woocommerce/events/customer-created.json)

### customer.updated

Confidence: documented · Schema: official schema

Customer account changes

Identified by: x-wc-webhook-topic header · Object: `customer`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/woocommerce/events/customer-updated.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `25` |

From WooCommerce docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/woocommerce/events/customer-updated.json)

### customer.deleted

Confidence: documented · Schema: official schema

User with the customer role is deleted

Identified by: x-wc-webhook-topic header · Object: `customer`

```json
{
  "id": 25
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | integer | `25` |

From WooCommerce docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/woocommerce/events/customer-deleted.json)

## order

### order.created

Confidence: documented · Schema: official schema

Order is created, excluding drafts

Identified by: x-wc-webhook-topic header · Object: `order`

```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
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/woocommerce/events/order-created.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `727` |
| `status` | string | `processing` |
| `prices_include_tax` | boolean | `false` |
| `customer_id` | integer | `0` |

From WooCommerce docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/woocommerce/events/order-created.json)

### order.updated

Confidence: documented · Schema: official schema

Order changes, or a refund is added or removed

Identified by: x-wc-webhook-topic header · Object: `order`

```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
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/woocommerce/events/order-updated.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `727` |
| `status` | string | `completed` |
| `prices_include_tax` | boolean | `false` |
| `customer_id` | integer | `0` |

From WooCommerce docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/woocommerce/events/order-updated.json)

### order.deleted

Confidence: documented · Schema: official schema

Order is moved to the trash

Identified by: x-wc-webhook-topic header · Object: `order`

```json
{
  "id": 727
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | integer | `727` |

From WooCommerce docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/woocommerce/events/order-deleted.json)

### order.restored

Confidence: documented · Schema: official schema

Order is restored from the trash

Identified by: x-wc-webhook-topic header · Object: `order`

```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
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/woocommerce/events/order-restored.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `727` |
| `status` | string | `processing` |
| `prices_include_tax` | boolean | `false` |
| `customer_id` | integer | `0` |

From WooCommerce docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/woocommerce/events/order-restored.json)

## product

### product.created

Confidence: verified · Schema: from a captured delivery

Product or variation is created

Identified by: x-wc-webhook-topic header · Object: `product`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/woocommerce/events/product-created.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `18` |
| `status` | string | `publish` |
| `type` | string | `simple` |
| `price` | string | `150` Watch out: Numeric string. |

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`

[View as JSON](https://hookdeck.com/webhooks/woocommerce/events/product-created.json)

### product.updated

Confidence: verified · Schema: from a captured delivery

Product or variation changes

Identified by: x-wc-webhook-topic header · Object: `product`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/woocommerce/events/product-updated.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `18` |
| `status` | string | `publish` |
| `type` | string | `simple` |
| `price` | string | `150` Watch out: Numeric string. |

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`

[View as JSON](https://hookdeck.com/webhooks/woocommerce/events/product-updated.json)

### product.deleted

Confidence: documented · Schema: official schema

Product is moved to the trash

Identified by: x-wc-webhook-topic header · Object: `product`

```json
{
  "id": 794
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | integer | `794` |

From WooCommerce docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/woocommerce/events/product-deleted.json)

### product.restored

Confidence: documented · Schema: official schema

Product is restored from the trash

Identified by: x-wc-webhook-topic header · Object: `product`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/woocommerce/events/product-restored.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `794` |
| `status` | string | `publish` |
| `type` | string | `simple` |
| `price` | string | `21.99` Watch out: Numeric string. |

From WooCommerce docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/woocommerce/events/product-restored.json)

### product.published

Confidence: documented · Schema: official schema

Product or variation moves to published status

Identified by: x-wc-webhook-topic header · Object: `product`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/woocommerce/events/product-published.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `794` |
| `status` | string | `publish` |
| `type` | string | `simple` |
| `price` | string | `21.99` Watch out: Numeric string. |

From WooCommerce docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/woocommerce/events/product-published.json)

---

Not affiliated with WooCommerce. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/woocommerce.json) · [Report a correction](https://hookdeck.com/contact)
