SendBase.Email 1.0.0

SendBase.Email SDK

Official .NET SDK for the SendBase Email API.

Installation

dotnet add package SendBase.Email

Quick Start

using SendBase.Email;
using SendBase.Email.Models.Requests;

var client = new SendBaseClient("your-api-key");

var response = await client.Emails.SendAsync(new SendEmailRequest
{
    FromEmail = "sender@yourdomain.com",
    FromName = "Your App",
    To = ["recipient@example.com"],
    Subject = "Hello from SendBase!",
    HtmlBody = "<h1>Welcome!</h1><p>This is a test email.</p>"
});

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

Dependency Injection

using SendBase.Email.Extensions;

builder.Services.AddSendBaseClient(options =>
{
    options.ApiKey = builder.Configuration["SendBase:ApiKey"]!;
    options.BaseUrl = "https://api.yourdomain.com";
    options.Timeout = TimeSpan.FromSeconds(30);
    options.Retry = new RetryPolicyOptions
    {
        MaxRetries = 3,
        InitialDelay = TimeSpan.FromMilliseconds(500)
    };
});

// Inject ISendBaseClient
public class EmailService(ISendBaseClient client)
{
    public async Task SendWelcomeEmail(string email)
    {
        await client.Emails.SendAsync(new SendEmailRequest
        {
            FromEmail = "welcome@yourdomain.com",
            To = [email],
            Subject = "Welcome!",
            HtmlBody = "<h1>Welcome to our service!</h1>"
        });
    }
}

Features

Send Emails

// Simple send
await client.Emails.SendAsync(new SendEmailRequest
{
    FromEmail = "sender@domain.com",
    To = ["recipient@example.com"],
    Subject = "Test",
    HtmlBody = "<h1>Hello</h1>"
});

// With attachments
await client.Emails.SendAsync(new SendEmailRequest
{
    FromEmail = "sender@domain.com",
    To = ["recipient@example.com"],
    Subject = "Report",
    HtmlBody = "<p>Please see attached report.</p>",
    Attachments =
    [
        EmailAttachment.FromBytes("report.pdf", pdfBytes, "application/pdf"),
        EmailAttachment.FromUrl("image.png", "https://example.com/image.png")
    ]
});

// Batch send
var batch = await client.Emails.SendBatchAsync(new SendBatchEmailRequest
{
    Emails =
    [
        new SendEmailRequest { FromEmail = "sender@domain.com", To = ["user1@example.com"], Subject = "Hi", HtmlBody = "Hello 1" },
        new SendEmailRequest { FromEmail = "sender@domain.com", To = ["user2@example.com"], Subject = "Hi", HtmlBody = "Hello 2" }
    ]
});

Domains

// Create domain
var domain = await client.Domains.CreateAsync(new CreateDomainRequest { Domain = "example.com" });

// List domains
var domains = await client.Domains.ListAsync();

// Verify domain
var verification = await client.Domains.VerifyAsync(domain.Id);

// Enable inbound
await client.Domains.EnableInboundAsync(domain.Id);

Templates

// Create template
var template = await client.Templates.CreateAsync(new CreateTemplateRequest
{
    Name = "Welcome Email",
    Subject = "Welcome {{name}}!",
    HtmlBody = "<h1>Hello {{name}}</h1><p>Welcome to our service.</p>"
});

// Preview with variables
var preview = await client.Templates.PreviewAsync(template.Id, new Dictionary<string, object>
{
    ["name"] = "John"
});

// Send using template
await client.Emails.SendAsync(new SendEmailRequest
{
    FromEmail = "sender@domain.com",
    To = ["recipient@example.com"],
    Subject = "Welcome",
    TemplateId = template.Id,
    TemplateData = new Dictionary<string, object> { ["name"] = "John" }
});

Webhooks

// Create webhook
var webhook = await client.Webhooks.CreateAsync(new CreateWebhookRequest
{
    Url = "https://yourapp.com/webhooks/email",
    Events = [WebhookEventType.EmailDelivered, WebhookEventType.EmailBounced]
});

// Test webhook
var test = await client.Webhooks.TestAsync(webhook.Id);

// Get delivery history
var deliveries = await client.Webhooks.GetDeliveriesAsync(webhook.Id);

Error Handling

using SendBase.Email.Exceptions;

try
{
    await client.Emails.SendAsync(request);
}
catch (SendBaseValidationException ex)
{
    Console.WriteLine($"Validation error: {ex.Message}");
}
catch (SendBaseAuthenticationException)
{
    Console.WriteLine("Invalid API key");
}
catch (SendBaseRateLimitException ex)
{
    Console.WriteLine($"Rate limited. Retry after: {ex.RetryAfter}");
}
catch (SendBaseNotFoundException)
{
    Console.WriteLine("Resource not found");
}
catch (SendBaseException ex)
{
    Console.WriteLine($"API error: {ex.Message} (Status: {ex.StatusCode})");
}

Available Clients

License

MIT