Quick setup examples

Django

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

Python has an official package — pip install mailblastr — and it works unchanged from a Django view. The example below instead calls the REST API directly with the `requests` library, so the send adds no new dependency beyond one you almost certainly already have. See SDKs for the package.

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://www.mailblastr.com/api/emails",
        headers={"Authorization": f"Bearer {os.environ['MAILBLASTR_API_KEY']}"},
        json={
            "from": "Acme <onboarding@yourdomain.com>",
            "to": ["delivered@mailblastr.dev"],
            "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.