Webhook event

`price.updated`

A price was archived or renamed.

Type: price.updated
The object it carries: the price object
Subscribe with: price.updated, price.* 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_vy8cj8yqeheyvzktymktwk5e",
  "object": "event",
  "livemode": true,
  "created": "2026-09-10T10:01:00.000Z",
  "type": "price.updated",
  "api_version": "2026-10-11",
  "data": {
    "object": {
      "id": "price_mbk5s5r45kwheaq89dbmk2gz",
      "object": "price",
      "livemode": true,
      "created": "2026-09-10T10:01:00.000Z",
      "product": "prod_9cct573e5ewmrj7f6hyjsqap",
      "active": false,
      "type": "one_time",
      "amount": "21.99",
      "currency": "USD",
      "recurring": null,
      "nickname": "Retail",
      "metadata": {}
    },
    "previous_attributes": {
      "active": true
    }
  },
  "request": {
    "id": null,
    "idempotency_key": null
  },
  "pending_webhooks": 1
}

Fields of data.object

Fields of data.object in price.updated
Field	In this example
`id`	`"price_mbk5s5r45kwheaq89dbmk2gz"`
`object`	`"price"`
`livemode`	`true`
`created`	`"2026-09-10T10:01:00.000Z"`
`product`	`"prod_9cct573e5ewmrj7f6hyjsqap"`
`active`	`false`
`type`	`"one_time"`
`amount`	`"21.99"`
`currency`	`"USD"`
`recurring`	`null`
`nickname`	`"Retail"`
`metadata`	An object with no fields

What each field means is on the page of the price 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.