Webhooks

Webhooks allow you to receive real-time HTTP notifications when events happen in your Emailit account, such as when an email is delivered, bounced, or when a contact is created.

Instead of polling the API for changes, webhooks push data to your server as events occur, enabling you to build reactive integrations and workflows.

How it works

1. You create a webhook endpoint in your application that accepts POST requests
2. You register the URL in the Emailit dashboard or via the API
3. When a subscribed event occurs, Emailit sends a POST request to your URL with the event payload
4. Your endpoint responds with a 2xx status code to acknowledge receipt

Event structure

Every webhook event follows a consistent structure:

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.delivered",
  "data": {
    "object": {
      ...
    }
  }
}

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.delivered",
  "data": {
    "object": {
      ...
    }
  }
}

Available events

Emailit sends webhook notifications for the following resource types:

• Emails — delivery lifecycle events (accepted, delivered, bounced, etc.)
• Domains — domain creation, updates, and deletion
• Audiences — audience management events
• Subscribers — subscriber lifecycle events
• Contacts — contact management events
• Templates — template creation, updates, and deletion
• Suppressions — suppression list changes
• Email Verifications — verification results
• Email Verification Lists — bulk verification list events

See Event Types for the complete list.

Next steps

• Event Types — Full list of all available event types
• Webhook Requests — How webhook HTTP requests are structured
• Request Signature — Verify webhook authenticity using signatures