pulumi-sendgrid 0.1.0a2

A Pulumi provider for managing SendGrid resources.

Pulumi SendGrid Provider

Community Provider

This is an unofficial, community-maintained Pulumi provider for SendGrid. It is not affiliated with, endorsed by, or supported by Pulumi Corporation or Twilio/SendGrid. This project is an independent effort to bring infrastructure-as-code capabilities to SendGrid using Pulumi.

• Not an official product - Created and maintained by the community
• No warranties - Provided "as-is" under the Apache 2.0 License
• Community support only - Issues and questions via GitHub

A native Pulumi provider for managing SendGrid resources.

Installation

Node.js (npm)

npm install @jdetmar/pulumi-sendgrid

Python (pip)

pip install pulumi-sendgrid

Go

go get github.com/JDetmar/pulumi-sendgrid/sdk/go/sendgrid

.NET (NuGet)

dotnet add package Community.Pulumi.Sendgrid

Configuration

Key	Environment Variable	Required	Description
sendgrid:apiKey	SENDGRID_API_KEY	Yes	SendGrid API key for authentication
sendgrid:baseUrl	—	No	API base URL (default: https://api.sendgrid.com). Use https://api.eu.sendgrid.com for EU regional subusers.

pulumi config set sendgrid:apiKey --secret SG.xxxxx
# or
export SENDGRID_API_KEY="SG.xxxxx"

Example (TypeScript)

import * as sendgrid from "@jdetmar/pulumi-sendgrid";

const apiKey = new sendgrid.ApiKey("myApiKey", {
  name: "my-app-api-key",
  scopes: ["mail.send", "alerts.read"],
});

const template = new sendgrid.Template("myTemplate", {
  name: "welcome-email",
  generation: "dynamic",
});

export const apiKeyId = apiKey.apiKeyId;
export const templateId = template.templateId;

See the examples/ directory for complete programs in Go, Python, .NET, and YAML.

Resources

Resource	Description
sendgrid:Alert	Email alerts for usage and statistics thresholds
sendgrid:ApiKey	API keys with scoped permissions
sendgrid:DomainAuthentication	Domain authentication (DKIM/SPF) for sender identity
sendgrid:EventWebhook	Webhooks for email event notifications
sendgrid:GlobalSuppression	Global unsubscribe entries
sendgrid:IpPool	IP pools for organizing dedicated IPs (Pro plan)
sendgrid:LinkBranding	Branded tracking links for click/open tracking
sendgrid:Subuser	Subuser accounts with independent settings (Pro plan)
sendgrid:Teammate	Teammate accounts with role-based access
sendgrid:Template	Transactional email templates
sendgrid:TemplateVersion	Versioned content for email templates
sendgrid:UnsubscribeGroup	Suppression groups for subscription management
sendgrid:VerifiedSender	Verified sender identities

Development

Prerequisites

• Go 1.24+
• Node.js
• Python 3
• .NET SDK
• pulumictl
• Pulumi CLI

Build and install

make build install

Run provider unit tests

make test_provider

Regenerate SDKs after provider changes

make codegen

License

Apache 2.0 — see LICENSE for details.