Skip to main content

​
Python SDK

The jetemail package is the official Python SDK for JetEmail transactional email (MIT license, Python 3.8+). Create a transactional API key in the dashboard: Outbound → Keys → Add API key. Use that key with the SDK.

​
Installation

pip install jetemail
Package on PyPI: jetemail.

​
Quick start

from jetemail import JetEmail

client = JetEmail("your-transactional-api-key")

result = client.email.send(
    from_address="Your App <[email protected]>",
    to="[email protected]",
    subject="Welcome!",
    html="<h1>Welcome!</h1>"
)
Use a from_address on a verified domain (see Getting started).

​
Constructor

# API key string
client = JetEmail("your-transactional-api-key")

# Or with options
client = JetEmail(
    api_key="your-transactional-api-key",
    base_url="https://api.jetemail.com"  # optional
)

​
client.email.send(**options)

Send a single email.
FieldRequiredDescription
from_address✓Sender, e.g. "Name <[email protected]>"
to✓Recipient(s), string or list (max 50)
subject✓Subject line
html*HTML body (need html and/or text)
text*Plain text (need html and/or text)
cc, bcc, reply_toRecipients (max 50 each)
headersCustom headers dict
attachmentsAttachments (max 40MB total)
Response shape: { "id": str, "response": str }.

​
client.batch.send(emails)

Send up to 100 emails in one request. Returns summary (total, successful, failed) and results per message. 
result = client.batch.send([
    {
        "from_address": "[email protected]",
        "to": "[email protected]",
        "subject": "Hello Alice",
        "html": "<p>Hi Alice!</p>",
    },
    {
        "from_address": "[email protected]",
        "to": "[email protected]",
        "subject": "Hello Bob",
        "html": "<p>Hi Bob!</p>",
    },
])

​
Attachments

from jetemail import Attachment

result = client.email.send(
    from_address="[email protected]",
    to="[email protected]",
    subject="Invoice",
    html="<p>Please find your invoice attached.</p>",
    attachments=[
        Attachment.from_path("/path/to/invoice.pdf"),
        Attachment.from_content("Hello World", "hello.txt"),
    ],
)

​
Error handling

from jetemail import JetEmail, JetEmailError

try:
    client.email.send(...)
except JetEmailError as e:
    print(e.status_code, e.message, e.response)
Common status codes: 400 invalid request, 401 bad/missing API key, 500 server error.
For additional examples and the full option list, see the PyPI package page. REST details: API reference.