LettermintDotNet 0.11.0

Lettermint C# SDK

A simple and elegant C# SDK for sending emails via Lettermint with a fluent API. Feel free to open an issue or a pull request to add more features.

Installation

Install the package via NuGet:

dotnet add package Lettermint

Or via Package Manager Console:

Install-Package Lettermint

Quick Start

1. Configure the Service

Add Lettermint to your service collection:

builder.Services.AddLettermint(options =>
{
    options.ApiKey = "your-api-key-here";
});

You can add whitelisted emails. This is good for dev og test environment where you want to make sure you dont hurt your domain reputation.

Supported formats: Exact email: "user@example.com" (also allows plus adresseing "user+tag@example.com" Domain wildcard: "*@example.com" (allows any email at this domain) Leave empty to disable filtering (all emails allowed - use in production)

builder.Services.AddLettermint(options =>
{
    options.ApiKey = "your-api-key-here";
    options.EmailWhitelist = ["email@one.dk", "Email@two.dk"];
});

2. Inject and Use

Inject ILettermintClient into your services or controllers:

public class EmailService(ILettermintClient _lettermint)
{
    public async Task SendWelcomeEmail(string recipientEmail, string name)
    {
        var response = await _lettermint.Email
            .From("noreply@yourdomain.com")
            .To(recipientEmail)
            .Subject("Welcome!")
            .Text($"Hello {name}, welcome to our service!")
            .SendAsync();

        Console.WriteLine($"Email sent! Message ID: {response.MessageId}");
    }
}

Usage Examples

Simple Text Email

var response = await _lettermint.Email
    .From("sender@example.com")
    .To("recipient@example.com")
    .Subject("Hello from Lettermint")
    .SetTextBody("This is a plain text email.")
    .SetRouteAsOutgoing()
    .SendAsync();

HTML Email

var response = await _lettermint.Email
    .From("sender@example.com")
    .To("recipient@example.com")
    .Subject("Newsletter")
    .SetHtmlBody("<h1>Welcome!</h1><p>Thank you for subscribing.</p>")
    .SetRouteAsOutgoing()
    .SendAsync();

All Email methods

var response = await _lettermint.Email
    .From("sender@example.com")
    .From("John", "john@john.com")
    .To("recipient@example.com")
    .To("John", "john@john.com")
    .Tag("Login")
    .Subject("Newsletter")
    .SetTextBody("This is a plain text email.")
    .SetHtmlBody("<h1>Welcome!</h1><p>Thank you for subscribing.</p>")
    .SetRouteAsOutgoing()
    .SetRouteAsBroadcast()
    .SetRoute("specificroute")
    .IdempotencyKey("12345678")
    .SendAsync();

License

MIT

Support

For issues and questions, please visit GitHub Issues.