🔌 API & integrations
Webhooks — receive events in real time
Subscribe to customer enrolled, stamp added, and reward earned events.
Updated 16 June 2026·3 min read
Configure webhooks in Dashboard → Settings → Developer to receive an HTTP POST every time something happens in Fidz.
Events
- customer.enrolled — a new customer joined.
- stamp.added — a stamp/visit was recorded.
- reward.earned — a customer hit the reward threshold.
Each delivery includes an x-fidz-signature header (HMAC-SHA256 over the body) so you can verify it came from Fidz using your webhook secret.
Delivery is best-effort with a 5-second timeout — a failing webhook never blocks or slows down a stamp, enrolment or redemption.