jetemail 0.1.0

JetEmail Python SDK for transactional email sending

JetEmail Python SDK

The official Python SDK for JetEmail transactional email.

Installation

pip install jetemail

Quick Start

from jetemail import JetEmail, SendEmailOptions

client = JetEmail(api_key="your_api_key")

result = client.emails.send(
    SendEmailOptions(
        from_="[e-mail]",
        to="[e-mail]",
        subject="Hello from JetEmail",
        html="<p>Welcome!</p>",
    )
)

print(result["id"])

Send an Email

from jetemail import JetEmail, SendEmailOptions, Attachment

client = JetEmail(api_key="your_api_key")

client.emails.send(
    SendEmailOptions(
        from_="You <[e-mail]>",
        to=["[e-mail]", "[e-mail]"],
        subject="Monthly Report",
        html="<h1>Report</h1><p>See attached.</p>",
        text="Report - see attached.",
        cc="[e-mail]",
        bcc="[e-mail]",
        reply_to="[e-mail]",
        headers={"X-Entity-Ref-ID": "report-2025-01"},
        attachments=[
            Attachment.from_path("/path/to/report.pdf"),
            Attachment.from_content("raw,csv,data", "data.csv"),
        ],
    )
)

Send Batch Emails

Send up to 100 emails in a single API call:

from jetemail import JetEmail, SendEmailOptions

client = JetEmail(api_key="your_api_key")

emails = [
    SendEmailOptions(
        from_="[e-mail]",
        to=recipient,
        subject="Hello!",
        html=f"<p>Hi {name}!</p>",
    )
    for name, recipient in [("Alice", "[e-mail]"), ("Bob", "[e-mail]")]
]

result = client.batch.send(emails)
print(result["summary"])

Webhook Verification

Verify incoming webhook signatures without a client instance:

from jetemail import verify_webhook
from jetemail.webhook_verification import WebhookSignatureVerificationFailed

try:
    verify_webhook(
        payload=request.body,             # raw bytes
        signature=request.headers["X-Webhook-Signature"],
        timestamp=request.headers["X-Webhook-Timestamp"],
        secret="your_webhook_secret",
        tolerance=300,                    # seconds (default)
    )
    # Signature is valid
except WebhookSignatureVerificationFailed as e:
    # Signature invalid or timestamp expired
    print(e)

Error Handling

from jetemail import JetEmail, SendEmailOptions, JetEmailError

client = JetEmail(api_key="your_api_key")

try:
    client.emails.send(
        SendEmailOptions(
            from_="[e-mail]",
            to="[e-mail]",
            subject="Test",
            html="<p>Hi</p>",
        )
    )
except JetEmailError as e:
    print(f"Status: {e.status_code}")
    print(f"Message: {e.message}")
    print(f"Response: {e.response}")

License

MIT