Smtpfa St Webhooks

generated: '2026-10-31'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://smtpfa.st/docs/webhooks
sources:
- https://smtpfa.st/docs/webhooks
- https://smtpfa.st/blog/logs-api-and-webhook-deliveries
- https://smtpfa.st/blog/webhook-best-practices
- https://smtpfa.st/blog/live-tail-real-time-email-logs
description: SMTPfast provides webhook events for email lifecycle and resource changes.
events:
- event: email.scheduled
  description: Email was accepted for a future send time.
- event: email.sent
  description: Email was accepted by the sending provider for delivery.
- event: email.delivered
  description: Email was accepted by the recipient's mail server.
- event: email.delivery_delayed
  description: A delivery attempt failed temporarily and SMTPfast will retry.
- event: email.bounced
  description: Email bounced (hard bounce or soft bounce).
- event: email.complained
  description: Recipient marked the email as spam.
- event: email.opened
  description: The tracking pixel was loaded.
- event: email.clicked
  description: Recipient clicked a tracked link in the email.
- event: email.failed
  description: Email failed after the final send attempt.
- event: email.suppressed
  description: Email was not sent because every recipient was suppressed.
- event: email.unsubscribed
  description: Recipient opted out via unsubscribe link or List‑Unsubscribe.
- event: email.received
  description: Inbound email was received and parsed.
- event: domain.created
  description: A sending domain was added.
- event: domain.updated
  description: A sending domain's verification state changed.
- event: domain.deleted
  description: A sending domain was deleted.
- event: contact.created
  description: A contact was created with POST /v1/contacts.
- event: contact.updated
  description: A contact was changed with PATCH /v1/contacts/:id.
- event: contact.deleted
  description: A contact was deleted.
- event: contact.subscribed
  description: A contact subscribed through a hosted form or confirmation flow.
delivery:
  signature: Webhook payloads are signed with a shared secret; the signature is sent in the `X‑SMTPFAST‑SIGNATURE` header.
  retries: Failed deliveries are automatically retried after 1 second, 30 seconds, 5 minutes and 30 minutes (up to 5 attempts total). After the
    final attempt the delivery is marked failed and retained in the log for 30 days.
docs: https://smtpfa.st/docs/webhooks