Send email in Python.

Install

Get a key under API keys in the dashboard and verify a sending domain first (how). Then add the library:

1pip install mailtruss

Send an email

This sends one message and passes an idempotency key, so repeating the request can never deliver it twice. A send is retried only when you pass an idempotency_key; reads and deletes retry on 429 and 5xx. from_ is sent as from.

1from mailtruss import Mailtruss
2​
3m = Mailtruss(api_key="ms_live_…")  # or set MAILTRUSS_API_KEY
4m.emails.send(
5    from_="Ada <ada@yourdomain.com>", to="you@example.com", subject="Hello",
6    html="<p>It works.</p>", idempotency_key="order-42",
7)

More on what you can put in a message (cc, bcc, attachments, tags, templates, scheduling) is under Sending.

Verify webhook signatures

Mailtruss signs every webhook with the Standard Webhooks scheme. Check the signature before you trust a request. Pass the raw body exactly as received, the request headers and the endpoint's signing secret. It raises ValueError when a header is missing, the timestamp is more than five minutes off, or no signature matches.

1import os
2from mailtruss import verify_webhook
3​
4def webhook(request):  # Flask-style handler
5    try:
6        event = verify_webhook(request.get_data(), request.headers, os.environ["MAILTRUSS_WEBHOOK_SECRET"])
7    except ValueError:
8        return "invalid signature", 400
9    return "ok"

Events, payloads and retries are on the Webhooks page.

Handle errors

Any non-2xx response raises MailtrussError with status, name, message and request_id; a timeout raises MailtrussTimeout. Every error name, with its cause and fix, is in the error catalogue.

Other languages

• Node.js
• Go
• PHP
• Ruby
• Java
• .NET
• curl and HTTP