> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Price Update | Webhook Events

> Fires when an existing price on a product is modified.

The `PriceUpdate` event fires whenever a price record is changed — for example, when the amount, currency, compare-at price, available quantity, or recurring interval is edited. Use this event to keep external storefronts, billing systems, and pricing analytics in sync without polling the API.

## Payload

| Field                      | Type      | Description                                                                     |
| -------------------------- | --------- | ------------------------------------------------------------------------------- |
| `_id`                      | `string`  | Unique identifier for the price                                                 |
| `locationId`               | `string`  | Account ID where the price resides                                              |
| `product`                  | `string`  | ID of the product this price belongs to                                         |
| `userId`                   | `string`  | ID of the user who last updated the price                                       |
| `name`                     | `string`  | Display name for the price (e.g., `"Red / S"`)                                  |
| `type`                     | `string`  | Pricing model — `one_time` for a single charge or `recurring` for subscriptions |
| `currency`                 | `string`  | ISO 4217 currency code (e.g., `USD`, `INR`)                                     |
| `amount`                   | `number`  | Updated price amount in the smallest currency unit                              |
| `compareAtPrice`           | `number`  | Original or strikethrough price used to show a discount                         |
| `availableQuantity`        | `number`  | Updated number of units available at this price                                 |
| `allowOutOfStockPurchases` | `boolean` | Whether purchases are allowed when stock is depleted                            |
| `variantOptionIds`         | `array`   | List of variant option IDs this price applies to                                |
| `membershipOffers`         | `array`   | Membership offers linked to this price, each with a `label`, `value`, and `_id` |
| `recurring`                | `object`  | Updated recurring billing configuration — `interval` and `intervalCount`        |
| `createdAt`                | `string`  | ISO 8601 timestamp when the price was originally created                        |
| `updatedAt`                | `string`  | ISO 8601 timestamp of this update                                               |

## Example payload

```json theme={null}
{
  "_id": "655b33aa2209e60b6adb87a7",
  "membershipOffers": [
    { "label": "top_50", "value": "50", "_id": "655b33aa2209e60b6adb87a7" }
  ],
  "variantOptionIds": ["h4z7u0im2q8", "h3nst2ltsnn"],
  "locationId": "3SwdhCsvxI8Au3KsPJt6",
  "product": "655b33a82209e60b6adb87a5",
  "userId": "6YAtzfzpmHAdj0e8GkKp",
  "name": "Red / S",
  "type": "one_time",
  "currency": "INR",
  "amount": 199999,
  "recurring": { "interval": "day", "intervalCount": 1 },
  "createdAt": "2023-11-20T10:23:38.645Z",
  "updatedAt": "2024-01-23T09:57:04.852Z",
  "compareAtPrice": 2000000,
  "availableQuantity": 5,
  "allowOutOfStockPurchases": true
}
```

## Related

* [Price Create](/api-reference/webhooks/price-create) — fires when a new price is added
* [Price Delete](/api-reference/webhooks/price-delete) — fires when a price is removed
* [Products API](/api-reference/products/overview) — create, retrieve, and manage products and prices programmatically