mailenv 1.0

Python client for the Mailenv API

mailenv

Transactional email for your app. This Python client lets you send transactional and promotional email through the Mailenv API so you can plug reliable, API-driven email straight into your SaaS, web app, or backend—password resets, welcome messages, notifications, and more. API docs.

Installation

pip install -e .

(Use your project’s normal install method if you have a pyproject.toml or setup.py.)

Basic usage

Set MAILENV_API_KEY in your environment to avoid passing the key in code, or pass api_key= to override.

from mailenv import Mailenv

client = Mailenv()  # uses MAILENV_API_KEY from env
# or: client = Mailenv(api_key="your-api-key")

result = client.send(
    to="[e-mail]",
    sender="[e-mail]",
    subject="Hello",
    message="Hi there.",
)

# result["id"], result["status"]

Optional arguments include email_type (default "tx"), sender_name, campaign_id, mailing_list_id, user_id, customer_id, priority, headers, and extra_data. See the client docstrings for details.

Errors

On API or request failure the client raises MailenvError:

from mailenv import Mailenv, MailenvError

try:
    result = client.send(...)
except MailenvError as e:
    print(e.message, e.status_code, e.body)