Price Events

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

JSON Example

{
  "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_code": "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_code": "CA",
        "base_price_amount": 129.99,
        "sale_price_amount": null,
        "currency_code": "CAD",
        "on_sale": false,
        "status": "active"
      }
    ]
  }
}

Field Descriptions

Field	Type	Description
variant_id	string	Unique identifier for the variant
product_id	string	ID of the parent product
store_group_id	string	ID of the store group
store_group_slug	string	Slug of the store group
variant_number	string	Variant number
markets	array	Price information for each market

Market Price Fields

Field	Type	Description
id	string	Unique identifier for the price record
market_id	string	ID of the market
market_slug	string	Slug of the market
country_code	string	Two-letter ISO country code
base_price_amount	number	Regular price amount
sale_price_amount	number|null	Sale price amount (if applicable)
currency_code	string	Three-letter ISO currency code
on_sale	boolean	Whether the variant is currently on sale
status	string	Price status (active, inactive)