Skip to main content
This section covers all webhook events related to variant prices.

​
Event Types

The following price-related events are available:
  • variant_prices.updated - Triggered when prices for a variant are updated

​
Variant Prices Updated Event

The variant_prices.updated event is triggered when prices for a variant are modified.

​
Event Structure

{
  "event_type": "variant_prices.updated",
  "payload": {
    "variant_id": "123e4567-e89b-12d3-a456-426614174000",
    "product_id": "123e4567-e89b-12d3-a456-426614174001",
    "store_group_id": "123e4567-e89b-12d3-a456-426614174002",
    "store_group_slug": "main-store",
    "variant_number": "VAR-123",
    "markets": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174003",
        "market_id": "123e4567-e89b-12d3-a456-426614174004",
        "market_slug": "us",
        "country_codes": ["US"],
        "base_price_amount": 99.99,
        "sale_price_amount": 79.99,
        "currency_code": "USD",
        "on_sale": true,
        "status": "active"
      },
      {
        "id": "123e4567-e89b-12d3-a456-426614174005",
        "market_id": "123e4567-e89b-12d3-a456-426614174006",
        "market_slug": "ca",
        "country_codes": ["CA"],
        "base_price_amount": 129.99,
        "sale_price_amount": null,
        "currency_code": "CAD",
        "on_sale": false,
        "status": "active"
      }
    ]
  }
}

​
Field Descriptions

FieldTypeDescription
variant_idstringUnique identifier for the variant
product_idstringID of the parent product
store_group_idstringID of the store group
store_group_slugstringSlug of the store group
variant_numberstringVariant number
marketsarrayPrice information for each market

​
Market Price Fields

FieldTypeDescription
idstringUnique identifier for the price record
market_idstringID of the market
market_slugstringSlug of the market
country_codestringTwo-letter ISO country code
base_price_amountnumberRegular price amount
sale_price_amountnumber|nullSale price amount (if applicable)
currency_codestringThree-letter ISO currency code
on_salebooleanWhether the variant is currently on sale
statusstringPrice status (active, inactive)