How to Configure Webhooks in MailerLogic

Webhooks allow MailerLogic to send real-time notifications to your applications whenever specific email events occur. Instead of repeatedly checking MailerLogic for updates, your application can automatically receive an HTTP request whenever a subscribed event is triggered.

You can use webhooks to automate email workflows, synchronize delivery data with external systems, track engagement, trigger notifications, and build real-time reporting and automation.

What You Can Use Webhooks For

• Track email delivery and engagement events

• Synchronize email activity with your CRM or application

• Trigger workflows when emails are delivered or bounced

• Monitor spam complaints and unsubscribes

• Update reporting dashboards in real time

• Automate actions based on email engagement

• Track activity across multiple domains

Step 1: Create a New Webhook

Navigate to 'Integrations' and select 'Webhooks'. Then, click '+ Create Webhook'.

Step 2: Configure the Webhook

Enter the webhook 'Name'. the 'Webhook URL' where MailerLogic should send webhook notifications and add a 'Description'.

Step 3: Select the Webhook Scope

Choose the 'Webhook Scope' and select the 'Domain' that should generate events for the webhook.

Step 4: Select Webhook Events

Select one or more events that should trigger the webhook. A single webhook can subscribe to multiple events.

Available Webhook Events

Step 5: Enable the Webhook

Select 'Active' to enable the webhook. Then click 'Create Webhook' to save the configuration.

Step 6: Verify the Webhook

After creating the webhook, it appears in the Webhooks list.

Step 7: Manage Existing Webhooks

From the 'Webhooks' page, you can manage your existing webhook configurations.

Depending on the webhook, you can:

• Regenerate webhook secret
• Edit the webhook configuration
• Delete the webhook

Regenerate Webhook Secret

If your webhook secret needs to be replaced, select 'Regenerate webhook secret' from the webhook options.

Sample Webhook Payloads

The following examples illustrate how webhook event data can be structured when MailerLogic sends notifications to your endpoint.

Email Sent

The Email Sent webhook is triggered when MailerLogic sends an email.

{
  "event": "email.sent",
  "created_at": "2026-09-23T11:28:18Z",
  "data": {
    "message_id": "msg_100001",
    "recipient": "john.doe@example.com",
    "domain": "some.teachly.io",
    "sent_at": "2026-09-23T11:28:18Z"
  }
}

Email Delivered

The Email Delivered webhook is triggered when an email is successfully delivered to the recipient's mail server.

{
  "event": "email.delivered",
  "created_at": "2026-09-23T11:29:04Z",
  "data": {
    "message_id": "msg_100001",
    "recipient": "john.doe@example.com",
    "domain": "some.teachly.io",
    "delivered_at": "2026-09-23T11:29:04Z"
  }
}

Email Opened

The Email Opened webhook is triggered when an email open is detected.

{
  "event": "email.opened",
  "created_at": "2026-09-23T11:31:22Z",
  "data": {
    "message_id": "msg_100001",
    "recipient": "john.doe@example.com",
    "domain": "some.teachly.io",
    "opened_at": "2026-09-23T11:31:22Z"
  }
}

Link Clicked

The Link Clicked webhook is triggered when a recipient clicks a tracked link in an email.

{
  "event": "link.clicked",
  "created_at": "2026-09-23T11:33:10Z",
  "data": {
    "message_id": "msg_100001",
    "recipient": "john.doe@example.com",
    "domain": "some.teachly.io",
    "url": "https://example.com/product",
    "clicked_at": "2026-09-23T11:33:10Z"
  }
}

Email Bounced

The Email Bounced webhook is triggered when an email is returned as undeliverable.

{
  "event": "email.bounced",
  "created_at": "2026-09-23T11:35:42Z",
  "data": {
    "message_id": "msg_100002",
    "recipient": "invalid@example.com",
    "domain": "some.teachly.io",
    "bounce_type": "hard",
    "bounced_at": "2026-09-23T11:35:42Z"
  }
}

Spam Complaint

The Spam Complaint webhook is triggered when a recipient reports an email as spam.

{
  "event": "spam.complaint",
  "created_at": "2026-09-23T11:38:15Z",
  "data": {
    "message_id": "msg_100003",
    "recipient": "john.doe@example.com",
    "domain": "some.teachly.io",
    "complaint_at": "2026-09-23T11:38:15Z"
  }
}

Unsubscribed

The Unsubscribed webhook is triggered when a recipient unsubscribes from email communications.

{
  "event": "email.unsubscribed",
  "created_at": "2026-09-23T11:40:08Z",
  "data": {
    "recipient": "john.doe@example.com",
    "domain": "some.teachly.io",
    "unsubscribed_at": "2026-09-23T11:40:08Z"
  }
}

Delivery Failed

The Delivery Failed webhook is triggered when email delivery fails.

{
  "event": "delivery.failed",
  "created_at": "2026-09-23T11:42:30Z",
  "data": {
    "message_id": "msg_100004",
    "recipient": "john.doe@example.com",
    "domain": "some.teachly.io",
    "reason": "Delivery failed",
    "failed_at": "2026-09-23T11:42:30Z"
  }
}

Verify Your Endpoint

Once your webhook is created:

1. Trigger one of the events selected for the webhook.

2. Confirm that your endpoint receives the webhook notification.

3. Verify the request using your webhook secret, if applicable.

4. Process the event and return a successful HTTP response to acknowledge receipt.

5. Check your application logs if the event is not received as expected.

Your endpoint should be configured to handle the webhook requests reliably and securely.

You have successfully configured webhooks in MailerLogic. Webhooks provide a convenient way to receive real-time email events, synchronize delivery and engagement data, and automate workflows across your applications.