Python

MailBlastr ships an official Python SDK — see Send emails with Python for the pip install mailblastr path — but you do not need it: this guide sends email by POSTing JSON to https://www.mailblastr.com/api/emails. The examples below use the popular `requests` library, but any HTTP client (including the stdlib urllib) works.

Prerequisites

• A MailBlastr API key.
• A verified domain to send from.
• Python 3.8 or newer if you install the official mailblastr package (it declares requires-python >= 3.8). The requests example below runs on older interpreters too.

1. Install an HTTP client

pip install requests

2. Set your API key

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

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://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 world",
        "html": "<strong>it works!</strong>",
    },
)
res.raise_for_status()
print(res.json()["id"])