Webhooks

Receive real-time notifications when events happen in PryceScan. Available on the Advanced plan and above.

Available events

Event	Description
price.changed	A competitor price changed for one of your products
smartprice.calculated	A new SmartPrice was calculated
alert.triggered	An alert rule condition was met
competitor.discovered	A new competitor was found for a product
monitor.completed	A price monitoring cycle completed

Payload format

{
  "event": "price.changed",
  "timestamp": "2026-03-28T06:00:00Z",
  "data": {
    "productId": "a1b2c3d4-...",
    "sku": "KSM156",
    "competitorId": "e5f6g7h8-...",
    "competitorDomain": "harveynorman.com.au",
    "oldPrice": "899.00",
    "newPrice": "849.00",
    "change": "-5.56%"
  }
}

Signature verification

Each webhook request includes an X-PryceScan-Signature header containing an HMAC-SHA256 signature of the request body. Verify this signature against your webhook secret to ensure the request is authentic.

Retry behaviour

If your endpoint returns a non-2xx status code, we retry up to 3 times with exponential backoff (1 minute, 5 minutes, 30 minutes). After 3 failures, the delivery is marked as failed and visible in your webhook logs.