Skip to main content

​
Prerequisites

To get the most out of this guide, you’ll need to:

​
1. Install

dotnet add package Emailr

​
2. Send emails using HTML

In the startup of your application, configure the DI container as follows: 
using Emailr;

builder.Services.AddOptions();
builder.Services.AddHttpClient<EmailrClient>();
builder.Services.Configure<EmailrClientOptions>( o =>
{
    o.ApiToken = Environment.GetEnvironmentVariable( "EMAILR_APITOKEN" )!;
} );
builder.Services.AddTransient<IEmailr, EmailrClient>();
Send an email using the injected IEmailr instance: 
using Emailr;

public class FeatureImplementation
{
    private readonly IEmailr _emailr;


    public FeatureImplementation( IEmailr emailr )
    {
        _emailr = emailr;
    }


    public Task Execute()
    {
        var message = new EmailMessage();
        message.From = "Acme <[email protected]>";
        message.To.Add( "[email protected]" );
        message.Subject = "hello world";
        message.HtmlBody = "<strong>it works!</strong>";

        await _emailr.EmailSendAsync( message );
    }
}

​
3. Try it yourself

ASP.NET Controller API

See the full source code.

List of .NET examples (API, Web, HTML rendering, Async sending).