---
id: django-sendgrid-v5
version: "1.3.1"
license: Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction,… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# django-sendgrid-v5 — An implementation of Django's EmailBackend compatible with sendgrid-python v5+

License: permissive · Maintenance: active · Downloads: 483.8K/mo

## What it is and what it does

django-sendgrid-v5 replaces Django's default SMTP email backend with one that routes all outgoing mail through SendGrid's REST API. Instead of configuring SMTP credentials, you set a SendGrid API key and point Django's EMAIL_BACKEND setting to the package's SendgridBackend class. It works with Django's standard send_mail() and EmailMessage classes, so existing code requires minimal changes.

The package extends Django's email system with SendGrid-specific features: dynamic template support with JSON data injection, email open and click tracking, unsubscribe group management, custom personalization arguments, scheduled send times, and IP pool selection. It also includes webhook helpers to cryptographically verify and process delivery events (bounces, opens, clicks) from SendGrid's event webhook, useful for tracking email status in your application's database.

Use it for:

- Replace SMTP with SendGrid's REST API for more reliable email delivery in production Django applications.
- Use SendGrid dynamic templates with personalized JSON data to send complex, branded emails from Django.
- Track email opens and clicks by enabling SendGrid's tracking features through simple configuration flags.
- Implement webhook handlers to log email delivery events (delivered, bounced, blocked) to your application database.
- Send emails in sandbox mode during development or testing to avoid accidentally sending real messages.
- Support multi-region deployments by switching SendGrid API endpoints (e.g., EU region) via configuration.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a Django email backend that sends messages through SendGrid's REST API instead of SMTP, with support for dynamic templates, tracking, and webhook signature verification.

Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and a permissive MIT license. It is well-suited for Django projects that already use or plan to adopt SendGrid for email delivery, offering both standard Django email functionality and SendGrid-specific features like dynamic templates and webhook event processing.

## Install

pip install django-sendgrid-v5
uv add django-sendgrid-v5
poetry add django-sendgrid-v5

## Installing django-sendgrid-v5

Before you install: Low friction installation with three straightforward dependencies (django, python-http-client, sendgrid). The package is actively maintained with recent commits and no known vulnerabilities.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install django-sendgrid-v5

# In Django settings.py:
EMAIL_BACKEND = "sendgrid_backend.SendgridBackend"
SENDGRID_API_KEY = os.environ["SENDGRID_API_KEY"]

# Then use Django's standard email API:
from django.core.mail import send_mail
send_mail('Subject', 'Message', 'from@example.com', ['to@example.com'])

Requires a SendGrid account and API key; set SENDGRID_API_KEY environment variable before use.

Verify before relying:

- Whether webhook signature verification works with all SendGrid event types beyond the documented examples.
- Performance characteristics when sending bulk emails or handling high-frequency webhook events.
- Compatibility with Django versions not explicitly listed in classifiers (3.2, 4.0, 4.1, 4.2, 5.0).

## Package facts

- License: Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction,… (full text in the JSON record) (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 483.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django sendgrid email backend, sendgrid rest api django, django email delivery sendgrid, sendgrid dynamic templates django, django smtp alternative sendgrid, sendgrid webhook verification django, django email tracking sendgrid, django-integration, email-delivery, sendgrid-api

[View on SkillFed](https://skillfed.io/packages/django-sendgrid-v5) · [View on PyPI](https://pypi.org/project/django-sendgrid-v5/)