{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with WooCommerce.",
  "vendor": "woocommerce",
  "name": "WooCommerce",
  "official_docs": "https://raw.githubusercontent.com/woocommerce/woocommerce-rest-api-docs/trunk/source/includes/wp-api-v3/_webhooks.md",
  "docs_checked": "2026-10-28",
  "url": "https://hookdeck.com/webhooks/woocommerce",
  "pages": [
    {
      "tab": "overview",
      "label": "Overview",
      "url": "https://hookdeck.com/webhooks/woocommerce"
    },
    {
      "tab": "events",
      "label": "Webhook events",
      "url": "https://hookdeck.com/webhooks/woocommerce/events"
    },
    {
      "tab": "mcp-events",
      "label": "MCP events",
      "url": "https://hookdeck.com/webhooks/woocommerce/mcp-events"
    },
    {
      "tab": "verify",
      "label": "Verify signatures",
      "url": "https://hookdeck.com/webhooks/woocommerce/verify"
    },
    {
      "tab": "guide",
      "label": "Production guide",
      "url": "https://hookdeck.com/webhooks/woocommerce/guide-duplicates-ordering-retries-timeouts"
    },
    {
      "tab": "skill",
      "label": "Agent skill",
      "url": "https://hookdeck.com/webhooks/woocommerce/skill"
    }
  ],
  "summary": "WooCommerce signs every webhook with X-WC-Webhook-Signature (HMAC-SHA256, base64, despite what the docs say).",
  "facts": [
    {
      "key": "signature_header",
      "label": "Signature header",
      "value": "X-WC-Webhook-Signature",
      "detail": "Format: <base64 digest>",
      "source": {
        "kind": "vendor-docs",
        "label": "WooCommerce docs",
        "href": "https://raw.githubusercontent.com/woocommerce/woocommerce-rest-api-docs/trunk/source/includes/wp-api-v3/_webhooks.md"
      },
      "doc_discrepancy": null
    },
    {
      "key": "scheme",
      "label": "Scheme",
      "value": "HMAC-SHA256, base64",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "WooCommerce docs",
        "href": "https://raw.githubusercontent.com/woocommerce/woocommerce-rest-api-docs/trunk/source/includes/wp-api-v3/_webhooks.md"
      },
      "doc_discrepancy": {
        "claim": "WooCommerce's docs say a blank secret defaults to the current API user's consumer secret, and its REST docs say an MD5 hash of the user's ID and username. In WooCommerce 11.2.1, the admin form and the REST API both generate a random 50-character password instead.",
        "url": "https://woocommerce.com/document/webhooks/",
        "confirmed": true
      }
    },
    {
      "key": "signed_material",
      "label": "Signed material",
      "value": "{raw body}",
      "detail": "The request body as sent, after WooCommerce has JSON-encoded it. No timestamp is part of it.",
      "source": {
        "kind": "vendor-docs",
        "label": "WooCommerce docs",
        "href": "https://raw.githubusercontent.com/woocommerce/woocommerce-rest-api-docs/trunk/source/includes/wp-api-v3/_webhooks.md"
      },
      "doc_discrepancy": null
    },
    {
      "key": "identified_by",
      "label": "How events are identified",
      "value": "x-wc-webhook-topic header",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "WooCommerce docs",
        "href": "https://raw.githubusercontent.com/woocommerce/woocommerce-rest-api-docs/trunk/source/includes/wp-api-v3/_webhooks.md"
      },
      "doc_discrepancy": null
    },
    {
      "key": "body_format",
      "label": "Body format",
      "value": "JSON",
      "detail": "Content type: application/json.",
      "source": {
        "kind": "vendor-docs",
        "label": "WooCommerce docs",
        "href": "https://raw.githubusercontent.com/woocommerce/woocommerce-rest-api-docs/trunk/source/includes/wp-api-v3/_webhooks.md"
      },
      "doc_discrepancy": null
    },
    {
      "key": "other_headers",
      "label": "Other headers",
      "value": "referer, x-wc-webhook-delivery-id, x-wc-webhook-event, x-wc-webhook-id, x-wc-webhook-resource, x-wc-webhook-source, x-wc-webhook-topic",
      "detail": null,
      "source": {
        "kind": "registry",
        "label": "Registry record",
        "href": "https://hookdeck.com/webhooks/woocommerce.json"
      },
      "doc_discrepancy": null
    },
    {
      "key": "agent_skill",
      "label": "Agent skill",
      "value": "npx skills add hookdeck/webhook-skills --skill woocommerce-webhooks",
      "detail": null,
      "source": {
        "kind": "webhook-skills",
        "label": "Agent skill →",
        "href": "https://hookdeck.com/webhooks/woocommerce/skill"
      },
      "doc_discrepancy": null
    }
  ],
  "not_yet_known": [],
  "enumeration": {
    "status": "partial",
    "source_url": "https://raw.githubusercontent.com/woocommerce/woocommerce-rest-api-docs/trunk/source/includes/wp-api-v3/_webhooks.md",
    "checked": "2026-07-28"
  },
  "counts": {
    "events": 16,
    "with_payload": 16,
    "captured": 5,
    "with_description": 16,
    "resources": 4,
    "confidence": {
      "verified": 5,
      "documented": 11,
      "inferred": 0
    }
  },
  "mcp": {
    "native": "unknown",
    "checked": null,
    "via_hookdeck": "any WooCommerce event"
  },
  "events": [
    {
      "name": "order.created",
      "resource": "order",
      "description": "Order is created, excluding drafts",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/woocommerce/events#order.created",
      "json": "https://hookdeck.com/webhooks/woocommerce/events/order-created.json"
    },
    {
      "name": "order.updated",
      "resource": "order",
      "description": "Order changes, or a refund is added or removed",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/woocommerce/events#order.updated",
      "json": "https://hookdeck.com/webhooks/woocommerce/events/order-updated.json"
    },
    {
      "name": "order.deleted",
      "resource": "order",
      "description": "Order is moved to the trash",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/woocommerce/events#order.deleted",
      "json": "https://hookdeck.com/webhooks/woocommerce/events/order-deleted.json"
    },
    {
      "name": "order.restored",
      "resource": "order",
      "description": "Order is restored from the trash",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/woocommerce/events#order.restored",
      "json": "https://hookdeck.com/webhooks/woocommerce/events/order-restored.json"
    },
    {
      "name": "product.created",
      "resource": "product",
      "description": "Product or variation is created",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/woocommerce/events#product.created",
      "json": "https://hookdeck.com/webhooks/woocommerce/events/product-created.json"
    },
    {
      "name": "product.updated",
      "resource": "product",
      "description": "Product or variation changes",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/woocommerce/events#product.updated",
      "json": "https://hookdeck.com/webhooks/woocommerce/events/product-updated.json"
    },
    {
      "name": "product.deleted",
      "resource": "product",
      "description": "Product is moved to the trash",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/woocommerce/events#product.deleted",
      "json": "https://hookdeck.com/webhooks/woocommerce/events/product-deleted.json"
    },
    {
      "name": "product.restored",
      "resource": "product",
      "description": "Product is restored from the trash",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/woocommerce/events#product.restored",
      "json": "https://hookdeck.com/webhooks/woocommerce/events/product-restored.json"
    },
    {
      "name": "product.published",
      "resource": "product",
      "description": "Product or variation moves to published status",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/woocommerce/events#product.published",
      "json": "https://hookdeck.com/webhooks/woocommerce/events/product-published.json"
    },
    {
      "name": "customer.created",
      "resource": "customer",
      "description": "Customer account is created",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/woocommerce/events#customer.created",
      "json": "https://hookdeck.com/webhooks/woocommerce/events/customer-created.json"
    },
    {
      "name": "customer.updated",
      "resource": "customer",
      "description": "Customer account changes",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/woocommerce/events#customer.updated",
      "json": "https://hookdeck.com/webhooks/woocommerce/events/customer-updated.json"
    },
    {
      "name": "customer.deleted",
      "resource": "customer",
      "description": "User with the customer role is deleted",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/woocommerce/events#customer.deleted",
      "json": "https://hookdeck.com/webhooks/woocommerce/events/customer-deleted.json"
    },
    {
      "name": "coupon.created",
      "resource": "coupon",
      "description": "Coupon is created",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/woocommerce/events#coupon.created",
      "json": "https://hookdeck.com/webhooks/woocommerce/events/coupon-created.json"
    },
    {
      "name": "coupon.updated",
      "resource": "coupon",
      "description": "Coupon changes",
      "confidence": "documented",
      "schema_source": "official schema",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/woocommerce/events#coupon.updated",
      "json": "https://hookdeck.com/webhooks/woocommerce/events/coupon-updated.json"
    },
    {
      "name": "coupon.deleted",
      "resource": "coupon",
      "description": "Coupon is moved to the trash",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/woocommerce/events#coupon.deleted",
      "json": "https://hookdeck.com/webhooks/woocommerce/events/coupon-deleted.json"
    },
    {
      "name": "coupon.restored",
      "resource": "coupon",
      "description": "Coupon is restored from the trash",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/woocommerce/events#coupon.restored",
      "json": "https://hookdeck.com/webhooks/woocommerce/events/coupon-restored.json"
    }
  ]
}