How to set up webhook on received email

Alex Yatsenko
3 min readFeb 26, 2024

--

Stockholm skyline
Stockholm Skyline

Hi, I’m Alex, the person who started ProxiedMail. Since 2020, I’ve been working on making a system that protects your data with a really good proxy email service. This service not only keeps your information safe but also lets you work with emails directly through an API.

Ever wondered about getting emails right in your app? Oh, and I should mention that it’s free for basic use, which should be plenty for small apps. We’re always thankful for your support and happy to support you too.

Use Cases

You could use it to display text on a big screen that visitors of your conference sent, in a photo printing machine, Zapier, or connect with the systems that don’t provide an API other than an email message.
You can transmit the email signal that you sent somewhere to make the control easier or link the signals sent via emails to another system that supports webhooks.

The last case was used by a customer who came to us to set up an alarm arming/disarming system via email message.
I don’t know much of the details, but it sounds cool.
Just think about what kind of great apps you can build using this tool.

Here are some varied use cases for the tool:

  1. Customer Support Automation: Automatically categorize and prioritize customer emails, ensuring that urgent support tickets are addressed quickly.
  2. Event Registration Confirmation: Use it to confirm registrations for events or webinars by sending emails directly into your management system, streamlining the process.
  3. Feedback Collection: Easily collect feedback by allowing users to send their thoughts directly into your application, where you can analyze and respond to them efficiently.
  4. Order Processing: Integrate it into your e-commerce platform to process orders or send out confirmation emails automatically, making the shopping experience smoother for your customers.

And many others!

How it works

ProxiedMail allows you to create proxy emails on our domains (pxdmail.com, pxdmail.net, proxiedmail.com) or with your domain attached to our system.

Then, using this kind of email you can set up forwarding real email (like a real email on old-fashioned Gmail, Protonmail, etc) and mainly set up a webhook to it.

If you want to omit forwarding to your real email you can use one of the system's real emails:

@int.proxiedmail.com
@proxiedmail-int.int

Example: blabla@int.proxiedmail.com but it should be unique in our system.

Let’s start:

  1. Sign up on ProxiedMail.com
  2. Verify your email (just find the verification letter in your inbox and click the confirmation).
  3. If you want you can attach the domain, if not — use those that are provided by us. You can find it in custom domains.
  4. Create any proxy email. With the system real email if you want to omit forwarding or with a real one.
  5. Dropdown “More” should be opened automatically but if you accidentally closed it, then — click “More”
  6. Click “Set up/manage webhook (developer only)”
  7. In this section, you can find the input to put the webhook URL, also we’re storing your API responses including the body and HTTP code. You can go here to troubleshoot your API.
  8. Test it. Send some emails to test it and check out the response logs.

Conclusion

Now you have a fully working webhook for your email with the ability to monitor the work quality.

If you want you can use our API that provides:
- Creating endless proxy emails with one of ProxiedMail domains
- Setting up forwarding email or disabling forwarding
- Setting up a callback to your URL
- Browsing received emails on the received emails endpoint
- Setting up custom domains. You can do everything using your domain as well.
- Domain-to-domain forwarding. Just in case you need it we can forward emails by mask, like *@domainhostedatproxiedmail.com -> *someotherdomain.com. In this case, the MX of the first domain should be pointed to ProxiedMail and the second domain should be verified by TXT record.

Please check out the following articles to dive deep into API:
Receiving emails with NodeJS
Receiving emails with PHP
Receiving emails with Laravel

If you fast-learned you can also start straight from the client:
https://github.com/proxied-mail/proxiedmail-js-client
https://github.com/proxied-mail/proxiedmail-php-client
https://github.com/proxied-mail/laravel-receive-email

I’m aware that none of you reading docs, so I’m just going to leave the link right here:
http://docs.proxiedmail.com/

You can dive into our webhook article as well: https://proxiedmail.com/en/webhook-on-email

See you next time!

--

--

Alex Yatsenko
Alex Yatsenko

Written by Alex Yatsenko

A software engineer from Kyiv, living in Porto. Founder of ProxiedMail