Botmail Pro Webhooks

generated: '2026-11-02'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://botmail.pro/guides/email-webhooks-for-ai-agents
sources:
- https://botmail.pro/guides/email-webhooks-for-ai-agents
- https://botmail.pro/compare/postmark
- https://botmail.pro/use-cases/agent-task-notifications
description: Botmail webhooks deliver email‑related events to a public HTTPS endpoint via POST.
events:
- event: message.received
  description: New incoming mail (the default).
- event: message.sent
  description: The agent sent a message.
- event: message.status
  description: Delivered, bounced, complained, blocked, held or failed.
- event: thread.updated
  description: A conversation changed.
- event: mailbox.claimed
  description: A human approved a claimed address.
delivery:
  auth: Bearer token is used when creating the webhook; deliveries are not authenticated with a header.
  signature: Botmail-Signature header contains t=<unix seconds>,v1=<hex> where v1 is HMAC‑SHA256 of t + "." + raw body keyed with the webhook
    secret (whsec_…).
  retries: Failed deliveries are retried with exponential backoff starting at 5 seconds and doubling up to 1 hour; events are delivered in order,
    a failing event blocks later ones; after 20 consecutive failures the webhook is disabled.
docs: https://botmail.pro/guides/email-webhooks-for-ai-agents