Finchnode Com Webhooks

generated: '2026-10-30'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://finchnode.com/docs/webhooks/receive-and-verify.md
sources:
- https://finchnode.com/docs/webhooks/receive-and-verify.md
- https://finchnode.com/docs/webhooks/retries-and-duplicates.md
- https://finchnode.com/docs/api/webhook-events.md
- https://finchnode.com/products/consent-ledger.md
description: FinchNode delivers signed webhook events to a public HTTPS endpoint. The request includes two headers – `FinchNode-Event-Id` and
  `FinchNode-Signature` – where the signature is an HMAC‑SHA256 of `<timestamp>.<raw‑body>` keyed with the secret that starts with `whsec_`. The
  endpoint must verify the signature, check the timestamp is within five minutes, and acknowledge with any 2xx status within five seconds. Duplicates
  are possible; deduplicate on the event’s `id`.
events:
- event: consent.granted
  description: Sent when a patient grants sharing consent to the application.
- event: consent.revoked
  description: Sent when a patient revokes previously granted sharing consent.
- event: consent.expired
  description: Sent when a previously granted sharing consent reaches its expiry.
- event: deletion.requested
  description: Sent when a patient requests deletion of their data.
- event: sync.completed
  description: Sent when a data synchronization operation finishes successfully.
- event: sync.partial
  description: Sent when a data synchronization operation finishes with partial results.
- event: sync.failed
  description: Sent when a data synchronization operation fails.
- event: records.updated
  description: Sent when health records are updated.
delivery:
  signature: HMAC‑SHA256 of `t` + "." + raw body, keyed with the webhook secret (`whsec_…`), provided in `FinchNode-Signature` header
  retries: 'FinchNode retries a failed delivery up to eight times over ~41 hours with exponential back‑off: 30 s, 2 min, 10 min, 1 h, 4 h, 12 h,
    24 h. After the eighth failure the event is dead‑lettered.'
docs: https://finchnode.com/docs/webhooks/receive-and-verify.md