Price Create | Webhook Events - HoopAI Help Center

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

{
  "_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
}

Price Update — fires when a price is modified
Price Delete — fires when a price is removed
Products API — create, retrieve, and manage products and prices programmatically

​Payload

​Example payload

​Related

Payload

Example payload

Related