Samva Dev Webhooks

generated: '2026-10-31'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://samva.dev/docs/platform/webhooks
sources:
- https://samva.dev/docs/platform/webhooks
- https://samva.dev/docs/platform/webhook-events
- https://samva.dev/docs/integrations/webhooks
- https://samva.dev/docs/api-reference/webhooks
description: Samva delivers signed webhook events for email messaging and contact changes.
events:
- event: message.sent
  description: Fires when Samva sends the email toward the recipient's mail server.
- event: message.delivered
  description: Fires when the recipient's mail server accepts the email.
- event: message.bounced
  description: Fires when the recipient's mail server permanently rejects the email.
- event: message.failed
  description: Fires when a send attempt fails for a reason other than a permanent bounce.
- event: message.opened
  description: Emitted for tracked sends when the email is opened.
- event: message.clicked
  description: Emitted for tracked sends when a link in the email is clicked.
- event: message.complained
  description: Fires when a recipient reports the email as spam.
- event: contact.unsubscribed
  description: Reports that a contact unsubscribed from a topic.
- event: contact.resubscribed
  description: Reports that a contact resubscribed to a topic.
- event: contact.consent_changed
  description: Reports a change to a contact's recorded consent.
- event: domain.warming.updated
  description: Reports an update to domain warming status.
delivery:
  signature: webhook-signature header (space‑separated v1,<base64>) covering webhook-id, webhook-timestamp and raw body
  retries: up to 8 attempts per event
  content_type: application/json
note: All deliveries are signed with a secret that starts with whsec_ and are verified using the @samva/webhooks verifier. The endpoint must respond
  with any 2xx status; otherwise the attempt fails and is retried on the schedule below.
docs: https://samva.dev/docs/platform/webhooks