This post is about how to create a mailinator clone using SendGrid Inbound parse webhooks and ASP.NET Core. Mailinator is a service which offers dynamic email inbox for testing purposes. In this post I am creating a similar service using SendGrid Inbound parse webhooks - which helps to listen for incoming emails. To start you need a SendGrid account. Once you create a SendGrid account, you need to authenticate a domain. For this post I have created an SendGrid account from Azure portal. You can create Authenticated domains from this Page. Next open your Inbound parse settings, you can get it from Settings > Inbound Parse or Inbound Parse Settings. Next you need to add your receiving domain and Webhook URL.
To add the Host URL, use the ngrok utility and run the ngrok command like this -
./ngrok http http://localhost:5000/. This command will help you to expose your localhost - aspnet core app to internet and able to receives webhook inputs from SendGrid.
You also need to update MX records of your domain records with Domain DNS settings. You can find more details about MX Records here. The MX record domain should be added as the Receiving domain.
Next create a ASP.NET Web Application using
dotnet new mvc command and add a API Controller with name
MailController. And add an action method which helps to receive the WebHook post.
The Mapper Service is a service, which helps to convert IFormCollection to an object with the help of Reflection. Here is the implementation.
Here is the
EmailModel class I got from SendGrid documentation.
CreatedOn fields added to store the information in the Database.
You can use the SendGrid Inboud Parse webhook feature to implement systems where users can send email to save data to applications, like Send Email to send file to Microsoft Teams Channels or you can able to test application email delivery and email confirmations etc.
Happy Programming :)