Send emails with Flask

Use the Python SDK from Flask routes, CLI commands, or background workers.

Install

bash

python -m pip install flask
python -m pip install ./packages/python-sdk

After the Python package is published, replace the local install with python -m pip install opensend.

Example

python

import os
from flask import Flask, jsonify, request
from opensend import OpenSend

app = Flask(__name__)
client = OpenSend(
    os.environ["OPENSEND_API_KEY"],
    base_url=os.environ.get("OPENSEND_BASE_URL"),
)

@app.post("/send")
def send_email():
    payload = request.get_json(silent=True) or {}
    email_address = payload.get("email")
    if not email_address:
        return jsonify({"error": "email is required"}), 400

    email = client.emails.send({
        "from": "OpenSend <onboarding@updates.example.com>",
        "to": email_address,
        "subject": "Hello from Flask",
        "html": "<p>Flask queued this email.</p>",
    })

    return jsonify({"id": email["id"]})

Notes

Keep OPENSEND_API_KEY in environment variables or your platform secret manager.
For Celery/RQ jobs, create the client once per worker process.
Use idempotency_key for retrying jobs.