Lettermint Webhooks

generated: '2026-10-26'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://lettermint.co/changelog/webhooks-for-team-projects-or-routes.md
sources:
- https://lettermint.co/changelog/webhooks-for-team-projects-or-routes.md
- https://lettermint.co/changelog/inbound-emails-receive-process-emails-webhooks.md
- https://lettermint.co/changelog/webhooks-sent-emails.md
- https://lettermint.co/docs/api-reference/team/webhook
description: Lettermint webhooks deliver JSON payloads for email‑related events. Each webhook has a URL, a signing secret used to verify a signature
  header, and optional basic‑auth credentials. Deliveries are signed; the secret is rotated via the API. No retry policy is documented on the
  pages.
events:
- event: message.created
  description: Sent when a transactional email is created in the system.
- event: message.sent
  description: Sent when a transactional email has been sent to the recipient’s mail server.
- event: message.delivered
  description: Sent when a transactional email is successfully delivered to the recipient’s inbox.
- event: message.hard_bounced
  description: Sent when a transactional email cannot be delivered due to a hard bounce.
- event: message.soft_bounced
  description: Sent when a transactional email cannot be delivered due to a soft bounce.
- event: message.spam_complaint
  description: Sent when a recipient marks the email as spam.
- event: message.failed
  description: Sent when a transactional email fails to be delivered for reasons other than hard or soft bounce.
- event: message.auto_replied
  description: Sent when an automatic reply (e.g., out‑of‑office) is received for a sent email.
- event: suppression.added
  description: Sent when an email address is added to your suppression list.
- event: suppression.removed
  description: Sent when an email address is removed from your suppression list.
delivery:
  signature: Each webhook includes a signing secret; the payload is signed and can be verified via a signature header (exact header name not specified
    on the pages).
  content_type: application/json
note: The documentation mentions a signing secret and optional basic authentication (has_basic_auth flag) but does not detail the exact header
  name or retry behavior.
docs: https://lettermint.co/changelog/webhooks-for-team-projects-or-routes.md