Webhook Events and Payload Reference

Reference for AhaSend email webhooks: every event type (delivered, bounced, opened, clicked, failed and more), payload format, signature headers and retries.

AhaSend webhook events report email delivery, engagement, suppression and domain changes; this reference lists every event and its payload. Use the webhook setup guide to configure an endpoint.

Available on Free, Pro and Max. See plans and features.

Event Types

Event type	Filter flag	Fires when	Payload
message.reception	on_reception	A message is accepted	Reference
message.delivered	on_delivered	The recipient server accepts the message	Reference
message.transient_error	on_transient_error	A delivery attempt has a temporary failure	Reference
message.failed	on_failed	Message delivery fails	Reference
message.bounced	on_bounced	The recipient server rejects the message	Reference
message.suppressed	on_suppressed	A suppression prevents sending	Reference
message.opened	on_opened	The tracking image is requested	Reference
message.clicked	on_clicked	A tracked link is requested	Reference
suppression.created	on_suppression_created	A suppression is created	Reference
domain.dns_error	on_dns_error	A sending domain has a DNS error	Reference

Inbound routing has a separate message.routing event.

Suppression Duration

See bounces and suppression durations for expiry rules and the next steps after a failed send.

Payload Structure

All webhook events use a consistent JSON structure:

Events contain type, webhook_id, timestamp, and an event-specific data object. The payload webhook_id identifies the configured endpoint; the webhook-id header identifies the delivery across retries. Inbound routes use route_id instead of webhook_id. Use the payload reference for each event above.

Delivery and Verification

Check signatures before trusting a payload, and use the retry policy to handle duplicate or failed deliveries. Manage endpoints with Create Webhook, List Webhooks, Update Webhook and Delete Webhook.

Related Guides

• API authentication, Permission scopes, Webhook setup.
• Webhook CLI, Local webhook testing, Signature verification.
• Retry policy, API errors, API rate limits.
• Tracking setup.