Webhook event

`price.created`

A price was created.

Type: price.created
The object it carries: the price object
Subscribe with: price.created, 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_xqm8g1ja42mvy77mj4jzsj1w",
  "object": "event",
  "livemode": true,
  "created": "2026-09-10T10:01:00.000Z",
  "type": "price.created",
  "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": true,
      "type": "one_time",
      "amount": "21.99",
      "currency": "USD",
      "recurring": null,
      "nickname": "Retail",
      "metadata": {}
    }
  },
  "request": {
    "id": "req_c454pdhvpfr55c7br4jvzqep",
    "idempotency_key": "a3f1c2de-7b0e-4a55-9d0c-2f6f1f0b8e11"
  },
  "pending_webhooks": 1
}

Fields of data.object

Fields of data.object in price.created
Field	In this example
`id`	`"price_mbk5s5r45kwheaq89dbmk2gz"`
`object`	`"price"`
`livemode`	`true`
`created`	`"2026-09-10T10:01:00.000Z"`
`product`	`"prod_9cct573e5ewmrj7f6hyjsqap"`
`active`	`true`
`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. This event carries no data.previous_attributes.

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.