Boundry with Django

Keep the helper in application code and call it from views, signals, or Celery tasks. This walkthrough covers installation, a server-side sending helper, and the production checks that matter for Django.

Install

This guide uses the published boundry-sdk package. Its generated source is public on GitHub.

terminalShell

Shell

pip install boundry-sdk

Add the server-side helper

In the Boundry dashboard, select the project you are integrating, then create a project API key. Store BOUNDRY_API_KEY in the framework’s secret or server environment. Never include a project key in browser code.

app/email.py

python

import os
from boundry import Boundry

client = Boundry(api_key=os.environ["BOUNDRY_API_KEY"])

def send_welcome_email(to: str):
    return client.emails.send({
        "from": "Acme <hello@acme.com>",
        "to": to,
        "subject": "Welcome to Acme",
        "html": "<p>It works.</p>",
    })

Production checklist

Send only from a domain verified in this regional project.
Move user-facing sends to the framework’s job system when available.
Reuse an idempotency key if you retry after an uncertain response.