> ## 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 Create | Webhook Events

> Fires when a new price is added to a product.

The `PriceCreate` event fires each time a new price is attached to a product in an account. Prices define how a product is sold — one-time, recurring, or linked to specific variant options. Use this event to sync pricing to external catalogs, update billing system configurations, or trigger promotions when introductory prices are introduced.

## Payload

| Field                      | Type      | Description                                                                               |
| -------------------------- | --------- | ----------------------------------------------------------------------------------------- |
| `_id`                      | `string`  | Unique identifier for the price                                                           |
| `locationId`               | `string`  | Account ID where the price was created                                                    |
| `product`                  | `string`  | ID of the product this price belongs to                                                   |
| `userId`                   | `string`  | ID of the user who created the price                                                      |
| `name`                     | `string`  | Display name for the price (e.g., `"Red / S"`)                                            |
| `priceType`                | `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`  | Price amount in the smallest currency unit (e.g., cents for USD)                          |
| `compareAtPrice`           | `number`  | Original or strikethrough price used to show a discount                                   |
| `availableQuantity`        | `number`  | Number of units available at this price; `0` means unlimited                              |
| `allowOutOfStockPurchases` | `boolean` | Whether purchases are allowed when stock is depleted                                      |
| `variantOptionIds`         | `array`   | List of variant option IDs this price applies to (e.g., specific size/color combinations) |
| `membershipOffers`         | `array`   | Membership offers linked to this price, each with a `label`, `value`, and `_id`           |
| `recurring`                | `object`  | Recurring billing configuration — `interval` (e.g., `day`, `month`) and `intervalCount`   |
| `recurring.interval`       | `string`  | Billing frequency unit (e.g., `day`, `week`, `month`, `year`)                             |
| `recurring.intervalCount`  | `number`  | Number of interval units between each billing cycle                                       |
| `createdAt`                | `string`  | ISO 8601 timestamp when the price was created                                             |
| `updatedAt`                | `string`  | ISO 8601 timestamp of the most recent 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",
  "priceType": "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 Update](/api-reference/webhooks/price-update) — fires when a price is modified
* [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