Send Email Using SendGrid Email Service with an Attachment
This article will walk you through the creation of ASP.NET Core MVC web application with C# language and send an email using SendGrid Email Service.
In a modern web application, email notification or verification has now become a major and important part of the application. Using email service, we can ensure application user registration, reset the password, mobile number verification, etc. verification process very smoothly, quickly and so secure way. Newsletters, Promotion and Shipping Notifications task can also have been done by using email service as well.
Therefore in any application, alarm email notification, security verification process and enable or set something new email notification, we can make sure using email service.
In this article, I will explain with details, how to send an email from ASP.NET Core MVC web application using Sendgrid email service. I will write a Sendgrid email service as well for send an email using C# language and by installing Sendgrid nuget package manager.
Prerequisite
Good knowledge of C# language, ASP.NET Core MVC application, and .NET CLI.
Background
Let’s move to this demonstration and create an ASP.NET Core MVC web application. But before moving to the practical demonstration, let’s understand the objective of this demonstration which tells what exactly will be covered in this article. So, here is the objective as follows:
- Create a SendGrid account
- Get API key from SendGrid account which already created
- Create a project
- Code implementation
- Conclusion
Create a SendGrid Account
Sendgrid is a cloud-based email service that ensures reliable email delivery, scalability, and real-time service analysis using the SendGrid application dashboard. SendGrid API helps in delivering your important emails over SMPT or HTTP.
You can create a free account from the Sendgrid website.

After successfully creating the SendGrid account, you can create SendGrid email service API key which is required in the application implementation.
SendGrid Dashboard: Create or get API Key from here.

Plan and Pricing
You can send 40,000 emails for the first 30 days, then 100/day forever. For more details, please visit the Sendgrid website, https://sendgrid.com/pricing/

Advantage of SendGrid
- 24 hours customer support
- Using dashboard, you can track Spam Reports, mail bounced back and other features as well.
- You can set daily/monthly mailing functionality.
- If server down, then you can put email service in queues.
Implementation
Let’s first create an ASP.NET Core MVC web Application from .NET Core CLI.
$ dotnet new sln -n SendGridDotNetCore
$ dotnet new mvc -n SendGridDotNetCore
$ dotnet sln SendGridDotNetCore.sln add SendGridDotNetCore/SendGridDotNetCore.csprojAPI Key and Email Info
In ASP.NET resource file, I put API key and send email related all info there so that it can access and edit in real-time execution.
Build and Run
$ dotnet build
$ dotnet run
$ dotnet watch runPublish and run
$ dotnet publish -o ./publish
$ dotnet AutoMapperDemo.dllHere in application UI, showing the email delivery details status.

Email Service Interface
public interface ISendGridEmailSender
{
Task<Tuple<string, string, string>> Execute(string filePath);
}Email Service Interface Implementation
public async Task<Tuple<string, string, string>> Execute(string filePath)
{
try
{
var apiKey = EmailComponents.apiKey;
var client = new SendGridClient(apiKey);
var messageEmail = new SendGridMessage()
{
From = new EmailAddress(EmailComponents.fromEmail, EmailComponents.fromEmaliUserName),
Subject = EmailComponents.Subject,
PlainTextContent = EmailComponents.plainTextContent,
HtmlContent = EmailComponents.htmlContent
}; messageEmail.AddTo(new EmailAddress
(EmailComponents.emailTo, EmailComponents.emailToUserName));
var bytes = File.ReadAllBytes(filePath);
var file = Convert.ToBase64String(bytes);
messageEmail.AddAttachment("Voucher Details Report.pdf", file);
var response = await client.SendEmailAsync(messageEmail);
return new Tuple<string, string, string>
(response.StatusCode.ToString(),response.Headers.ToString(),response.Body.ToString());
}
catch (Exception ex)
{
throw ex;
}
}
Add Attachment in Email Boday
var messageEmail = new SendGridMessage();
var bytes = File.ReadAllBytes(filePath);
var file = Convert.ToBase64String(bytes);
messageEmail.AddAttachment("Voucher Details Report.pdf", file);Controller
public class SendEmailController : Controller
{
private readonly IHostingEnvironment _hostingEnvironment;
ISendGridEmailSender _ISendGridEmailSender;
public SendEmailController(IHostingEnvironment hostingEnvironment,
ISendGridEmailSender ISendGridEmailSender)
{
_hostingEnvironment = hostingEnvironment;
_ISendGridEmailSender = ISendGridEmailSender;
}// GET: SendEmail
public ActionResult Index()
{
return View();
}[HttpPost]
public async Task<IActionResult> SendMail()
{
var filePath = _hostingEnvironment.ContentRootPath + @"/ProjectNotes/VoucherDetails.pdf";
var result = await _ISendGridEmailSender.Execute(filePath);
Thread.Sleep(3000);
ViewBag.SendGridStatusCode = result.Item1;
ViewBag.SendGridHeaders = result.Item2.Replace("\r\n", " <***> ");
ViewBag.SendGridBody = result.Item3.Replace("\r\n", " <***> ");
return await Task.Run(() => View());
}
}
Startup
services.AddTransient<ISendGridEmailSender, SendGridEmailSender>();Conclusion
Using SendGrid email service, C# nuget package manager and ASP.NET Core MVC web application, we can simply send now an email from the application. Additionally, you can add an attachment with an email and SendGrid email service will send it by attaching in the email body as well!
Cheers!
Github Repo: https://github.com/csharplang/Sendgrid
Reference:
https://sendgrid.com/solutions/email-api/
https://github.com/sendgrid/sendgrid-csharp
https://www.nuget.org/packages/Sendgrid/
