Heyresearch Xyz Webhooks

generated: '2026-11-11'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://heyresearch.xyz/docs/webhooks
sources:
- https://heyresearch.xyz/docs/webhooks
- https://heyresearch.xyz/developers?tab=webhooks
- https://heyresearch.xyz/docs/terminal/chart-with-build-events.webp
- https://heyresearch.xyz/docs/terminal/chart-around-this-event.webp
description: HEY Research Lab provides webhooks that push signed change events to a subscriber URL. Each delivery includes a HMAC‑SHA256 signature
  in the `hey-signature` header and no additional authentication. Deliveries are retried on a fixed schedule and redirects are not followed.
events:
- event: build.release
  description: A release was published.
- event: build.ship
  description: Another meaningful ship (feature, integration, docs).
- event: build.status_changed
  description: The activity status moved.
- event: build.dormant
  description: The activity status moved.
- event: build.resumed
  description: The activity status moved.
- event: build.accelerating
  description: 'The development‑window signal: shipping faster.'
- event: research.published
  description: A project page was published.
- event: research.builder_verified
  description: A builder was verified.
- event: research.source_added
  description: An official source appeared.
- event: research.source_unavailable
  description: An official source stopped answering.
- event: research.source_restored
  description: An official source came back.
- event: research.source_changed
  description: A material change to what an official site declares.
- event: contract.deployed
  description: The launch deploy.
- event: contract.followup_deployed
  description: A later contract from the project's deployer.
- event: contract.implementation_changed
  description: A proxy's implementation changed (an upgrade log).
- event: contract.interface_changed
  description: The verified interface changed.
- event: contract.source_verified
  description: The source was verified.
- event: market.status_changed
  description: The token's market status moved (live, low liquidity, etc.).
- event: token.launch_stage_changed
  description: Launch stage changed.
- event: token.verification_changed
  description: Token verification changed.
- event: lock.unlock_due
  description: A HoodLock unlock enters its last seven days.
- event: lock.observed
  description: HEY first read a HoodLock lock.
- event: lock.withdrawn
  description: HEY first read it withdrawn.
- event: event.retracted
  description: An event you were sent is no longer public.
- event: ping
  description: Sent when a subscription is made, re‑pointed, re‑enabled, or on request.
delivery:
  signature: hey-signature (HMAC‑SHA256 of "<t>.<raw body>")
  content_type: application/json
note: Deliveries are retried on a fixed schedule and never follow redirects.
docs: https://heyresearch.xyz/docs/webhooks