React to what changes

When your app needs to do something as the feed lands a change — clear a cache, re-render a page, notify a team — webhooks tell you the moment it happens.

Subscribe to record events

A webhook is a URL of yours that Search Stack calls. Subscribe to record events on your catalog list and each add, update or deactivation is posted to your endpoint — no polling.

POST https://api.searchstack.dev/webhook/Demo
X-API-Key: {your key}
Content-Type: application/json

{
  "target_url": "https://yourapp.com/hooks/searchstack",
  "events": ["searchresult.created", "searchresult.updated", "searchresult.deactivated"]
}

What you receive

Each change arrives as a small POST — enough to act on without re-fetching everything:

{
  "event": "searchresult.deactivated",
  "account": "Demo",
  "list": "catalog",
  "id": "sku-1003"
}

Verify the signature on each call so you know it really came from Search Stack.

Go deeper: Webhooks — events, delivery and signing in the reference.