Quick setup examples

Django

Send your first email from a Django view by calling the MailBlastr API with requests.

Send your first email from a Django app by calling the MailBlastr REST API directly. The mailblastr SDK is for Node.js — Python users POST JSON to https://api.mailblastr.com/emails with the `requests` library from a view.

Prerequisites

A MailBlastr API key.
A verified domain to send from.

1. Install an HTTP client

Pip

pip install requests

2. Set your API key

Read the key from the environment so it never lives in source.

.env

MAILBLASTR_API_KEY=mb_xxxxxxxxx

3. Send email from a view

POST the email body to the MailBlastr API from a Django view. The easiest way to send is with the html field.

views.py

import os
import requests
from django.http import JsonResponse


def send_email(request):
    res = requests.post(
        "https://api.mailblastr.com/emails",
        headers={"Authorization": f"Bearer {os.environ['MAILBLASTR_API_KEY']}"},
        json={
            "from": "Acme <onboarding@yourdomain.com>",
            "to": ["delivered@example.com"],
            "subject": "Hello from Django",
            "html": "<strong>it works!</strong>",
        },
    )
    res.raise_for_status()
    return JsonResponse({"id": res.json()["id"]})

For richer HTML, render a Django template to a string and pass it as the html field.

views.py

from django.template.loader import render_to_string

html = render_to_string("emails/welcome.html", {
    "user_name": "Django Developer",
    "dashboard_url": "https://example.com/dashboard",
})
# ...then pass html=... in the JSON body above.

A successful call returns the created email's id. See every supported field in the Send an email reference.