Skip to documentation content
HintadataDocs

Price watches

Create, update, pause, and remove customer price watches.

In this guide
  1. 1Create an email price watch
  2. 2Update or pause a watch
  3. 3Protect notification destinations
In this guide
  1. 1Create an email price watch
  2. 2Update or pause a watch
  3. 3Protect notification destinations

Create an email price watch

json
{
  "canonical_product_id": "sony_wh1000xm5_black",
  "target_price": 280,
  "channel": "email",
  "destination": "buyer@example.com"
}

POST the body to /watchlists with Bearer authentication and a stable X-Price-Compare-Client-Id. Store the returned watch ID for later updates and deletion.

Update or pause a watch

PATCH can change the target price, destination, or status. Use paused when the rule may be resumed later; delete the watch when the customer no longer wants it retained.

Protect notification destinations

Treat email destinations as personal data. Restrict access, avoid logging full addresses, and remove watches according to the customer’s retention and deletion requirements.

Was this page helpful?
Price watches – Docs | Hintadata