Webhook Events

Live

The protocol events your program receives and how to handle them reliably.

HeartBadge fires webhooks for every protocol event that affects your program: badge activation, reward delivery, event check-in, tier change. This page is the catalog. For implementation patterns, see the developer guide on handling webhooks.

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 catalog: what fires when
Payload structure and signing
Delivery guarantees: at-least-once, ordering
Retries and dead-letter behavior
Idempotency keys and how to use them