How do I send an email with attachments using StrongGrid?

Use the Attachment.FromLocalFile method to create attachments, then pass them as a parameter to methods like SendToSingleRecipientAsync. The README provides a clear code example for including multiple attachments in emails.

StrongGrid vs SendGrid official C# SDK: which is better?

StrongGrid offers more comprehensive API coverage and extra features like webhook parsing and a warmup engine, but SendGrid's official SDK might have better vendor support. Choose StrongGrid for advanced needs and type safety.

How to parse signed webhooks in ASP.NET Core with StrongGrid?

Use the WebhookParser.ParseSignedEventsWebhookAsync method, providing the public key, signature, and timestamp from request headers. The README includes a full example with error handling for security exceptions.

What is the warmup engine and how do I set it up?

The warmup engine gradually increases email volume on new IP addresses to avoid spam filters. Set it up by creating WarmupSettings, initializing the WarmupEngine, and calling PrepareWithExistingIpAddressesAsync or PrepareWithNewIpAddressesAsync once.

Does StrongGrid support .NET 8 and dependency injection?

Yes, StrongGrid supports .NET 8 and includes built-in integration with Microsoft.Extensions.DependencyInjection via the AddStrongGrid extension method, as shown in the README for web apps and console applications.

Can I use StrongGrid with SendGrid's dynamic templates?

Yes, StrongGrid fully supports dynamic templates with Handlebars syntax. Create a template with TemplateType.Dynamic, specify merge fields, and send emails using dynamic data objects, as detailed in the README.

Open-Awesome

StrongGrid

C#0.115.0

A strongly typed .NET library for SendGrid's v3 API, including webhook parsing and IP warmup features.

GitHub

196 stars40 forks0 contributors

What is StrongGrid?

StrongGrid is a strongly typed .NET library that provides full access to SendGrid's v3 API, including email sending, contact management, and marketing features. It solves the problem of SendGrid's original C# client lacking type safety and comprehensive API coverage by offering a robust, fully-featured alternative. The library also includes utilities for parsing SendGrid webhooks and managing IP warmup processes.

Target Audience

.NET developers building applications that integrate with SendGrid for email sending, marketing automation, or contact management. It's particularly useful for those who need type safety, full API access, or advanced features like webhook parsing and IP warmup.

Value Proposition

Developers choose StrongGrid for its comprehensive coverage of SendGrid's API, strong typing that improves developer experience, and additional features like webhook parsing and a customizable warmup engine not found in the official SDK. Its seamless integration with .NET dependency injection systems ensures proper HTTP client management.

Overview

Strongly typed library for the entire SendGrid v3 API, including webhooks

Use Cases

Best For

Building .NET applications that send transactional emails via SendGrid
Managing SendGrid contacts, lists, and segments programmatically
Parsing and validating SendGrid webhooks in ASP.NET Core applications
Implementing IP warmup schedules for new SendGrid IP addresses
Using SendGrid's dynamic templates with Handlebars syntax in C#
Integrating SendGrid API with dependency injection in .NET projects

Not Ideal For

Projects that only require basic email sending without contact management or webhook parsing
Teams relying on SendGrid's official SDK for direct vendor support and guaranteed compatibility updates
Non-.NET applications or polyglot environments using other programming languages

Pros & Cons

Pros

Full API Coverage

Provides access to all SendGrid v3 resources including mail, contacts, lists, and segments, as demonstrated by examples in the README like importing contacts and retrieving API keys.

Strong Typing

Eliminates the use of dynamic types, ensuring compile-time safety and improved developer experience, which was a core motivation for the library's creation.

Advanced Webhook Parser

Supports parsing both Event and Inbound Parse webhooks with built-in validation for signed webhooks, simplifying integration in ASP.NET Core applications.

Customizable Warmup Engine

Includes a warmup engine with SendGrid's recommended schedules and progress tracking, helping manage IP reputation for new email-sending infrastructure.

Cons

API Version Lock-in

Tightly coupled to SendGrid's v3 API; if SendGrid deprecates or significantly changes the API, users may face breaking changes or delayed updates.

Complexity Overhead

The extensive feature set, such as the warmup engine and webhook parsing, adds unnecessary complexity for projects with simple transactional email needs.

.NET-Only Limitation

Exclusively targets .NET frameworks, making it unsuitable for multi-language projects or teams using technologies like Node.js or Python.

Frequently Asked Questions

Related Projects

MailKit

A cross-platform .NET library for IMAP, POP3, and SMTP.

Stars6,856

Forks867

Last commit19 days ago

Papercut

Papercut SMTP -- The Simple Desktop Email Server

Stars3,331

Forks305

Last commit16 days ago

FluentEmail

All in one email sender for .NET. Supports popular senders (SendGrid, MailGun, etc) and Razor templates.

Stars3,217

Forks447

Last commit2 years ago

MimeKit

A .NET MIME creation and parser library with support for S/MIME, PGP, DKIM, TNEF and Unix mbox spools.

Stars2,001

Forks390

Last commit7 days ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub