How to use webhooks to receive emails in your apps

A quick note: Webhooks are only available on Premium / Business plans.

With ImprovMX, you can configure your incoming emails to be sent as structured JSON to your web application.

This is simply done by entering a URL (starting with http:// or https://) as your redirection email instead of an email.

Note that you can also use both since we allow multiple values on the redirection field. All you need to do is separate them by a comma, like :

email@example.com, https://requestbin.com/r/enbwnegkb25v

When the forward destination on ImprovMX’s servers is an URL, like in the example above, we parse the email’s content and build a JSON from this.

Then, we send a POST request to your URL with the JSON as the body.

If we receive a status code of 2xx, we consider the delivery successful. Otherwise, when the status code is 4xx or 5xx, we retry up to two times (so three in total). If, after all the retries, we were unable to deliver the email to your web application, we stop trying.

Here’s a sample of a JSON structure we send:

{ "headers": { "X-Forwarding-Service": "ImprovMX v3.0.0", "Received-SPF": "pass (improvmx.com: domain of example.com designates xxx.xxx.xxx.xxx as permitted sender) receiver=mx1.improvmx.com; client-ip=xxx.xxx.xxx.xxx; helo=example.com;", "Delivered-To": "example@yourdomain.com", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=improvmx.com; i=@improvmx.com; q=dns/txt; s=20191126; t=1581630208; h=date : from : to : subject : content-type : message-id; bh=pwCRxelulesFS4CeB7c7JkXr7yW4Mx6hmFEr6sYnDiQ=; b=hBXwNE3Akntj0cf0qC+WdATn85jDPJzyyQNHvIeOQwUVk0E9FWbcX3HPC32sXITuYbLM9 9UtVQ1GK4u/k0NMXSzJfZtjcmjV4fnmHgbmmiapdOKE4f+816p0H8Htwvj/j5+OHShLk9Iy J8KdQ3f4kfHzp46+ZRymh/Z2HUHveDU/2v2w269FYIVAdWZddtbnBB7FRHFJt29i7FKSDeR FMwuo3UBZugKY3pVMMR0sYazpgOxvBYKEv7ymhtIl/nxcxq6xb2vc0qDl51HPhkwjQ5NhyT ZsDyJp/36NYaiiY4W1ZNxayxVtpJYPCCApLFZS20cfOCG3OYL8qjWZBYu1lg==", "Authentication-Results": "mx1.improvmx.com; spf=pass (improvmx.com: domain of example.com designates xxx.xxx.xxx.xxx as permitted sender) smtp.mailfrom=example.com; dkim=none" }, "to": [ { "name": "Example user", "email": "example@yourdomain.com" } ], "from": { "name": "Email Test", "email": "test@example.com" }, "subject": "This is a sample email to show the webhooks", "message-id": "random-message-id-generated@example.com", "date": "Thu, 13 Feb 2020 13:44:12 -0800", "return-path": { "name": null, "email": "test@example.com" }, "timestamp": 1581601452, "text": "This is a sample text that is present in the email's body as the text/plain value.", "htmlt": "TitleThis is a sample text that is present in the email's body as the text/html value." }

To ensure that requests are coming from a trusted source, it is recommended to whitelist the IP address of the ImprovMX webhook server. This will allow incoming traffic from that specific IP address to bypass any security measures or filters in place, while blocking all other incoming traffic.

It is important to only whitelist trusted IP addresses to ensure the security and integrity of your system. Please note that the ImprovMX webhook server's IP address is listed below:

15.237.103.194

Still have questions?

If you have any other queries please get in touch with our support team.

Was this helpful?