Webhook management

Webhooks allow you to receive real-time event data from MX18 directly into your system. They enable automation, analytics, and immediate response to recipient actions — such as opens, clicks, unsubscribes, and bounces.

What are webhooks?

A Webhook is an HTTP callback that sends data to your server when specific events occur.

Instead of polling for updates, your application can receive live event streams (like delivered, bounce, click, etc.) pushed directly from MX18 as they happen.

How to configure webhooks in MX18

Setting up a webhook is simple and can be done in just a few clicks.

Log in to app.mx18.com
Go to Settings > Webhook Management
Click Add Webhook
Enter your desired endpoint URL (must be HTTPS)
Optionally, click Send Test Event to validate your setup

You can add upto 5 webhooks, each pointing to different services or systems if needed.

Events sent via webhooks

MX18 delivers all 9 event types to your webhook endpoint, as described in the Events Tracking page:

Processed
Bounced
Dropped
Deferred
Delivered
Open
Click
Spam Report
Unsubscribe

Each event is sent as a separate JSON POST request to your configured endpoint.

Retry policy & failure handling

MX18 has built-in retry logic in case your endpoint is temporarily unavailable:

We retry up to 3 times dynamically with backoff
If your webhook continues to fail, the event is not stored or retried further
You’ll receive alerts via email or dashboard notification when repeated failures occur

MX18 only supports real-time event delivery. There is no replay queue for failed webhook requests. Ensure high availability of your endpoint for guaranteed delivery.

Debugging webhook issues

If you're experiencing integration or delivery problems:

Ensure your endpoint uses HTTPS and returns 2xx status codes
Temporarily disable firewalls or rate limits to isolate issues
Contact support@mx18.com to request webhook logs for debugging

Need help?

Need assistance in setting up or validating your webhook?

Visit the dashboard under Settings > Webhook Management
Or contact support@mx18.com