How to Send Transactional Emails in FastAPI with Mailofly

import os
from fastapi import FastAPI, BackgroundTasks, HTTPException
from pydantic import BaseModel, EmailStr
from mailofly import Mailofly

app = FastAPI(title="FastAPI Email Service")
client = Mailofly(api_key=os.environ.get("MAILOFLY_API_KEY"))

class EmailSchema(BaseModel):
    email: EmailStr
    name: str

def send_welcome_email(email: str, name: str):
    """Worker task executed in background thread pool."""
    client.emails.send(
        sender="Acme <support@yourdomain.com>",
        to=email,
        subject=f"Welcome to Acme, {name}!",
        html=f"<h3>Hello {name},</h3><p>Your account is ready to use.</p>",
    )

@app.post("/register")
async def register_user(user: EmailSchema, background_tasks: BackgroundTasks):
    # Perform user registration logic...
    
    # Schedule email send in background without blocking API response
    background_tasks.add_task(send_welcome_email, user.email, user.name)
    
    return {"status": "success", "message": "User registered and email queued."}