SplatDev.Messaging.SendGrid 1.0.2

SplatDev.Messaging.SendGrid

SendGrid email provider for SplatDev.Messaging — sends emails via the SendGrid Web API using the official SendGridClient. Supports CC/BCC, HTML and plain-text bodies, and both single and bulk delivery with full async support.

Compatibility

Installation

dotnet add package SplatDev.Messaging.SendGrid

Configuration

Constructor

using SplatDev.Messaging.SendGrid.Controllers;

var sendGrid = new SendGridController(
    apiKey: "SG.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx");

• apiKey — Your SendGrid API key (starts with SG.)

DI registration (recommended)

builder.Services.AddSingleton<ISendGridController>(sp =>
{
    var apiKey = builder.Configuration["SendGrid:ApiKey"];
    return new SendGridController(apiKey!);
});

Usage

The SendGridController implements IMessagingController<SendGridMessage, Response>, providing a consistent interface across all SplatDev messaging providers.

Send a single email

using SplatDev.Messaging.Interfaces;
using SplatDev.Messaging.SendGrid.Models;

var msg = new SendGridMessage
{
    From = new EmailAddress("no-reply@example.com", "SplatDev"),
    Subject = "Welcome!",
    HtmlContent = "<h1>Welcome aboard!</h1>",
    PlainTextContent = "Welcome aboard!",
};

msg.AddTo(new EmailAddress("customer@example.com", "Customer"));
msg.AddCc(new EmailAddress("admin@example.com", "Admin"));
msg.AddBcc(new EmailAddress("archive@example.com", "Archive"));

var response = await sendGrid.SendMessageAsync(msg);

if (response.IsSuccessStatusCode)
    Console.WriteLine($"Sent! Status: {response.StatusCode}");
else
{
    var body = await response.Body.ReadAsStringAsync();
    Console.WriteLine($"Failed ({response.StatusCode}): {body}");
}

Bulk send

var bulk = new SendGridMessage
{
    From = new EmailAddress("news@example.com", "Newsletter"),
    Subject = "Monthly Update",
    HtmlContent = "<p>Hello, %%name%%!</p>",
    PlainTextContent = "Hello, %%name%%!",
    MailSettings = new MailSettings { SandboxMode = new SandboxMode { Enable = false } }
};

// Add multiple tos for bulk delivery
bulk.AddTo(new EmailAddress("user1@example.com", "User One"));
bulk.AddTo(new EmailAddress("user2@example.com", "User Two"));
bulk.AddTo(new EmailAddress("user3@example.com", "User Three"));

var bulkResponse = await sendGrid.SendMessageAsync(bulk);

Sync version

var response = sendGrid.SendMessage(msg); // synchronous wrapper

Features

• Full IMessagingController<SendGridMessage, Response> implementation
• Truly async via SendMessageAsync — awaits the SendGrid Web API
• Sync convenience wrappers
• CC and BCC recipient support
• HTML and plain-text body support
• Single and bulk email delivery
• Uses the official SendGrid SDK (SendGridClient)
• Response object exposes StatusCode, Body, and IsSuccessStatusCode

Dependencies

Target Frameworks

• net8.0 — for Umbraco 13 applications
• net10.0 — for Umbraco 17 applications

SplatDev.Messaging.SendGrid — part of the SplatDev.Umbraco.Plugins suite. Licensed under MIT. © SplatDev Ltda.

Changelog

1.0.2 — 2026-08-24

Removes a dashboard screenshot that showed an error toast. It was captured against a site where this plugin's API was unreachable, so it advertised a broken dashboard. No screenshot is better than a misleading one; a replacement will be taken against a working install.

1.0.1 — 2026-08-24

Package metadata only: the listing now carries an icon and search tags, and the project and repository links point at the organisation that actually hosts this code. No code changes.

1.0.0 — 2026-08-24

This package now keeps a changelog. Earlier releases predate it and are not reconstructed here — consult the repository history for those. From this version on, every release records what changed for someone using it.