Render25 1.0.1

Render25 .NET / C# SDK

The official .NET client library for the Render25 transactional email platform.

Installation

Install via NuGet Package Manager:

dotnet add package Render25

Or via Package Manager Console:

Install-Package Render25

Quickstart

using Render25;

// Automatically reads RENDER25_API_KEY from environment variables
var client = new Render25Client();

// Or pass explicitly: var client = new Render25Client("re_live_...");

var response = await client.Emails.SendAsync(new SendEmailOptions
{
    From = "support@yourdomain.com",
    To = new List<string> { "customer@example.com" },
    Subject = "Welcome to Render25!",
    Html = "<h1>Welcome aboard!</h1><p>Transactional email sent via .NET.</p>",
    Text = "Welcome aboard! Transactional email sent via .NET."
});

Console.WriteLine($"Dispatched Message ID: {response.Id}");

Advanced: CC, BCC, Reply-To & Attachments

using Render25;

var client = new Render25Client();

byte[] pdfBytes = await File.ReadAllBytesAsync("invoice.pdf");

var response = await client.Emails.SendAsync(new SendEmailOptions
{
    From = "support@yourdomain.com",
    To = new List<string> { "client@example.com" },
    Cc = new List<string> { "accounting@example.com" },
    Bcc = new List<string> { "archive@example.com" },
    ReplyTo = "helpdesk@yourdomain.com",
    Subject = "Your Invoice #1042",
    Html = "<p>Please find your receipt and statement attached.</p>",
    Attachments = new List<Attachment>
    {
        Attachment.FromBytes("invoice_1042.pdf", pdfBytes, "application/pdf")
    }
});

Console.WriteLine($"Message ID: {response.Id}");

ASP.NET Core Dependency Injection

In Program.cs:

builder.Services.AddSingleton(new Render25Client(builder.Configuration["Render25:ApiKey"]));

In your controller or Minimal API endpoint:

app.MapPost("/api/send-receipt", async (Render25Client render25, OrderDto order) =>
{
    var res = await render25.Emails.SendAsync(new SendEmailOptions
    {
        From = "billing@yourdomain.com",
        To = new List<string> { order.CustomerEmail },
        Subject = $"Order #{order.Id} Receipt",
        Html = $"<p>Thank you for your order of ${order.TotalAmount}.</p>"
    });

    return Results.Ok(new { success = true, id = res.Id });
});

License

MIT © Render25