Webhook event

`product.updated`

A product was changed or archived.

Type: product.updated
The object it carries: the product object
Subscribe with: product.updated, product.* or *

Example payload

The body of the request your endpoint receives, shown here over several lines. On the wire it is compact JSON; check its signature over the bytes exactly as they arrive.

Example payload

{
  "id": "evt_ny10yft2skfsedpnnz6gvfx0",
  "object": "event",
  "livemode": true,
  "created": "2026-10-12T08:00:00.000Z",
  "type": "product.updated",
  "api_version": "2026-10-11",
  "data": {
    "object": {
      "id": "prod_9cct573e5ewmrj7f6hyjsqap",
      "object": "product",
      "livemode": true,
      "created": "2026-09-10T10:00:00.000Z",
      "updated": "2026-10-12T08:00:00.000Z",
      "name": "Ethiopia Yirgacheffe, 1 kg",
      "description": "Washed, light roast.",
      "image": "file_3mg14w9wm9h26h2v61wzxhek",
      "active": false,
      "metadata": {
        "sku": "ETH-YIR-1KG"
      }
    },
    "previous_attributes": {
      "active": true
    }
  },
  "request": {
    "id": null,
    "idempotency_key": null
  },
  "pending_webhooks": 1
}

Fields of data.object

Fields of data.object in product.updated
Field	In this example
`id`	`"prod_9cct573e5ewmrj7f6hyjsqap"`
`object`	`"product"`
`livemode`	`true`
`created`	`"2026-09-10T10:00:00.000Z"`
`updated`	`"2026-10-12T08:00:00.000Z"`
`name`	`"Ethiopia Yirgacheffe, 1 kg"`
`description`	`"Washed, light roast."`
`image`	`"file_3mg14w9wm9h26h2v61wzxhek"`
`active`	`false`
`metadata`	An object with `sku`

What each field means is on the page of the product object. data.previous_attributes holds the old values of exactly the fields that changed: here active.

Endpoints behind it

Calls that change products and prices. An event is also sent when a payer, the network, a timer or a person in the dashboard causes the change; the sentence above says which.