Day3 App Webhooks

generated: '2026-11-05'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.day3.app/webhooks
sources:
- https://docs.day3.app/webhooks
- https://docs.day3.app/webhooks/endpoints
description: Day3 webhooks deliver event notifications about email lifecycle and suppression actions.
events:
- event: email.sent
  description: Handed to the mail provider. Not yet delivered.
- event: email.delivered
  description: The receiving server accepted it.
- event: email.bounced
  description: Came back. bounce_type Permanent and Undetermined suppress the address; Transient is informational.
- event: email.complained
  description: Marked as spam. The address is suppressed.
- event: email.failed
  description: Never left. data.error says why.
- event: suppression.created
  description: An address was suppressed. data.reason is hard_bounce, complaint, unsubscribe, manual or provider_suppressed.
delivery:
  signature: Day3-Signature header containing t=<unix seconds>,v1=<hex> which is an HMAC‑SHA256 of `${t}.${rawBody}` keyed with the endpoint’s
    signing secret.
  content_type: application/json; request body must be verified raw before JSON parsing.
note: Endpoint URLs must be public HTTPS on port 443 or 8443; redirects are never followed; the request includes headers Day3-Event-Id, Day3-Event-Type,
  Day3-Delivery-Attempt, and Day3-Signature. The secret is provided once when creating the endpoint and can be rotated via the app.
docs: https://docs.day3.app/webhooks