DocumentationAPI ReferenceKnowledge Base
Quick setup examples

Python

Send your first email from Python using requests against the MailBlastr API.

MailBlastr has no Python SDK — you send email by POSTing JSON to https://api.mailblastr.com/emails. The examples below use the popular `requests` library, but any HTTP client (including the stdlib urllib) works.

Prerequisites

1. Install an HTTP client

Pip
pip install requests

2. Set your API key

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

.env
MAILBLASTR_API_KEY=mb_xxxxxxxxx

3. Send email using HTML

The easiest way to send an email is with the html field.

import os
import requests

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 world",
        "html": "<strong>it works!</strong>",
    },
)
res.raise_for_status()
print(res.json()["id"])
Inside Flask, FastAPI, or Django, call the API the same way from your view/route handler. See Send an email for every body field.