Usewheelhouse Webhooks

generated: '2026-11-03'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://help.usewheelhouse.com/en/articles/16324280-how-do-i-set-up-a-wheelhouse-webhook-subscription.md
sources:
- https://help.usewheelhouse.com/en/articles/16324280-how-do-i-set-up-a-wheelhouse-webhook-subscription.md
- https://help.usewheelhouse.com/en/articles/16324284-what-can-i-build-with-wheelhouse-webhooks.md
- https://docs.usewheelhouse.com/rm/reference/webhooks
- https://help.usewheelhouse.com/en/articles/11594263-how-do-i-set-events-seasons.md
description: Wheelhouse webhooks deliver events about listings. Events are batched within a 5‑minute window and include a `data.listing_ids` array.
  Deliveries are sent to an HTTPS (`https://`) endpoint.
events:
- event: recommendations.updated
  description: A listing's price recommendation changed.
- event: reservations.ingested
  description: New reservation data landed for a listing.
- event: flags.detected
  description: A listing tripped one of Wheelhouse's flags.
delivery:
  signature: Wh-Signature header of the form t=<unix timestamp>,v1=<hex> (HMAC‑SHA256 of "<t>.<raw request body>")
  retries: At‑least‑once delivery; failed attempts are retried with backoff over roughly 20 minutes. Retries reuse the same `Wh-Event-Id` header.
    If a subscription keeps failing it is automatically disabled.
  content_type: application/json
note: Wheelhouse only delivers to `https://` URLs and times out after 15 seconds.
docs: https://help.usewheelhouse.com/en/articles/16324280-how-do-i-set-up-a-wheelhouse-webhook-subscription.md