Skip to content

Mail — Email Service Configuration (SendGrid)

Last reviewed: 2026-05-29

Transactional email is automatically triggered by user actions (sign-ups, password resets, order confirmations, notifications). SendGrid is a cloud-based email delivery platform that handles sending at scale with high deliverability.

Overview

This folder stores configuration for SendGrid API integration, used for sending transactional emails from applications. SendGrid provides: - SMTP relay service - REST API for email sending - Email templates (dynamic templates) - Delivery analytics (opens, clicks, bounces, spam reports) - Suppression management (unsubscribes, bounces) - IP reputation management

Training Content

  • API key(s) for programmatic email sending
  • Sender verification details (sender email, domain authentication)
  • Integration instructions for various platforms

⚠️ Security note: API key file — credentials are not shown in the training listing for security reasons.

SendGrid Integration

SMTP Configuration

Setting Value
Server smtp.sendgrid.net
Port 587 (TLS) or 465 (SSL)
Username apikey
Password Your SendGrid API key

API Usage (REST)

# Send email via SendGrid API v3
curl --request POST \
  --url https://api.sendgrid.com/v3/mail/send \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "personalizations": [{"to": [{"email": "recipient@example.com"}]}],
    "from": {"email": "sender@yourdomain.com"},
    "subject": "Hello from SendGrid",
    "content": [{"type": "text/plain", "value": "Email body text"}]
  }'

Python with sendgrid library

from sendgrid import SendGridAPIClient
from sendgrid.helpers.mail import Mail

message = Mail(
    from_email='sender@yourdomain.com',
    to_emails='recipient@example.com',
    subject='Hello',
    plain_text_content='Email body'
)
sg = SendGridAPIClient('YOUR_API_KEY')
response = sg.send(message)

Email Deliverability Best Practices

  1. Authenticate your domain:
  2. SPF — Sender Policy Framework (authorized sending IPs)
  3. DKIM — DomainKeys Identified Mail (cryptographic signing)
  4. DMARC — Domain-based Message Authentication, Reporting & Conformance
  5. Warm up your sending IP — Gradually increase volume when using a new IP
  6. Monitor bounces and complaints — Remove invalid addresses, respect unsubscribe requests
  7. Use dedicated sending IPs — For high-volume senders
  8. Avoid spam triggers — No misleading subject lines, clean HTML, proper text/plain alternative

SendGrid Features

Feature Description
Dynamic Templates Handlebars-based email templates managed in SendGrid UI
Substitution Tags Personalize emails with user-specific data
Categories Track email performance by category tag
Suppression Groups Managed unsubscribe groups
Webhooks Receive real-time event data (delivered, opened, clicked, bounced)
Batch sending Send to multiple recipients with personalized content

Resources