Emalc

Search Documentation

Quickly jump to any guide, document, or section...

Webhooks Overview

Webhooks enable your backend application to receive real-time HTTP push notifications whenever email delivery, audience, domain, or suppression events occur in your Emalc account.

Instead of continuously polling our REST API to verify whether an email was delivered, opened, or bounced, Emalc dispatches structured JSON event payloads directly to your designated HTTPS webhook endpoints in real time.


Why Use Webhooks?#

  • Real-Time Telemetry: Track email deliveries, opens, clicks, bounces, and spam complaints as they happen.
  • Automate Workflows: Trigger internal application workflows, update user profiles, or flag hard-bounced email addresses automatically.
  • Zero Polling Overhead: Eliminate unnecessary REST API polling loops and save rate limit quota.
  • Cryptographically Secure: Authenticate incoming events using signed HMAC-SHA256 request headers (x-emalc-signature).

Standard HTTP Headers#

Every HTTPS POST payload sent from Emalc includes standard request headers:

Header NameExample ValueDescription
Content-Typeapplication/jsonFormat of the webhook body payload.
User-AgentEmalc-Webhook/1.0Identifies Emalc's delivery agent.
x-emalc-timestamp1727524800UNIX timestamp (seconds) when the payload was signed.
x-emalc-signaturev1=8f93a021b47e...HMAC-SHA256 hex signature derived from your endpoint secret (whsec_...).

Quickstart Setup Guide#

  1. Navigate to Settings -> Webhooks in your Emalc dashboard.
  2. Click Add Webhook Endpoint.
  3. Enter your public HTTPS URL (e.g., https://api.yourdomain.com/webhooks/emalc).
  4. Select the event types you want to subscribe to (or choose Select All).
  5. Save your endpoint and copy your secret key (whsec_...).
  6. Implement Signature Verification in your endpoint handler.

Next Steps#