Python Transactional Email API & SDK

Asynchronous and Synchronous Python Support

Whether you are building with FastAPI, Flask, Django, or asynchronous background workers like Celery and RQ, SendPorter gives you ergonomic client options with zero bloat.

import os
import requests

def send_transactional_email(to_email: str, receipt_id: str, amount: float):
    url = "https://api.sendporter.com/v1/send"
    headers = {
        "Authorization": f"Bearer {os.environ['SENDPORTER_API_KEY']}",
        "Content-Type": "application/json",
    }
    payload = {
        "from": "billing@yourdomain.com",
        "to": to_email,
        "subject": f"Payment Receipt #{receipt_id}",
        "html": f"<p>Thank you for your payment of <strong>{amount} USD</strong>.</p>",
        "tags": ["billing", "receipt"],
        "track_opens": True,
        "track_clicks": True,
    }

    response = requests.post(url, json=payload, timeout=5)
    response.raise_for_status()
    data = response.json()
    print("Parcel tracking ID:", data.get("id"))
    return data

import os
import httpx
from fastapi import FastAPI, BackgroundTasks

app = FastAPI()

async def async_send_welcome(email: str):
    async with httpx.AsyncClient() as client:
        await client.post(
            "https://api.sendporter.com/v1/send",
            headers={"Authorization": f"Bearer {os.environ['SENDPORTER_API_KEY']}"},
            json={
                "from": "hello@yourdomain.com",
                "to": email,
                "subject": "Welcome to our platform!",
                "html": "<h1>Welcome aboard!</h1><p>We're thrilled to have you.</p>",
            },
            timeout=10.0,
        )

@app.post("/signup")
async def signup(email: str, background_tasks: BackgroundTasks):
    background_tasks.add_task(async_send_welcome, email)
    return {"status": "user created, email queued"}

import hmac
import hashlib

def verify_webhook_signature(payload_bytes: bytes, signature_header: str, secret: str) -> bool:
    computed_signature = hmac.new(
        secret.encode("utf-8"),
        msg=payload_bytes,
        digestmod=hashlib.sha256
    ).hexdigest()

    return hmac.compare_digest(computed_signature, signature_header)

Production Patterns for Python Applications

Ensure reliable message dispatch in production web applications with these core guidelines:

• Persistent HTTP Sessions: Reuse a requests.Session() or httpx.AsyncClient() instance across requests to maintain TCP keep-alive connections and shave 40ms off TLS handshakes.
• Structured Parcel Tracking: Log the id returned in SendPorter's JSON response to your structured log aggregator (Datadog, CloudWatch, Grafana Loki) for end-to-end tracing.
• Automatic Retries on 5xx: Configure urllib3.util.Retry on your session to retry idempotently on transient network hiccups.