Skip to content
HeartBadge docs

Badge Webhooks

Live

Events fired for badge minting, activation, supersession, and HRTB tier changes.

Badge webhooks cover every event on the identity chain that affects your program's badges — new mints, activations, covenant supersessions, and HRTB tier transitions at recompute time.

This page is being written.

The structure is fixed. The prose is being drafted from the source material and reviewed by HeartChain Labs before publication. If you need this information urgently, email docs@heartbadge.com .

What this page will cover

  • Event types: badge.minted, badge.activated, badge.superseded, hrtb.tier_changed
  • Payload structure
  • Timing vs. on-chain confirmation
  • HRTB recompute cadence and what the tier_changed event contains