Elastic Email Python SDK

The official Python client library for the Elastic Email REST API v4.

Installation • Quick start • Examples • API reference • Models • Contributing

Features

• Transactional and bulk email. Send single messages, bulk campaigns or CSV merge-file sends.
• Contacts, lists and segments. Add, update, import, export and bulk-delete contacts.
• Campaigns and automations. Create, update, pause and trigger automations for a contact.
• Templates, files and attachments. Manage templates and uploaded files.
• Domains. Verify sending domains and check SPF, DKIM, tracking and certificate status.
• Webhooks and inbound routes. Receive delivery events and route incoming mail.
• Statistics, events and suppressions. Track delivery, bounces, complaints and unsubscribes.
• Subaccounts and security. Manage subaccounts and API keys.
• Typed models. Request and response models are Pydantic v2 classes, and the package ships type hints (py.typed).

Requirements

You'll also need an Elastic Email API key. You can create one in your API settings. Each endpoint's documentation lists the access level it needs.

Installation

Install the ElasticEmail package from PyPI:

pip install ElasticEmail

Or with Poetry or uv:

poetry add ElasticEmail
uv add ElasticEmail

Then import the package:

import ElasticEmail

Quick start

Configure the client

import os

import ElasticEmail
from ElasticEmail.rest import ApiException
from ElasticEmail.models import (
    BodyContentType,
    BodyPart,
    EmailContent,
    EmailTransactionalMessageData,
    TransactionalRecipient,
)

configuration = ElasticEmail.Configuration(host="https://api.elasticemail.com/v4")
configuration.api_key["apikey"] = os.environ["ELASTICEMAIL_API_KEY"]

Send a transactional email

message = EmailTransactionalMessageData(
    recipients=TransactionalRecipient(to=["john.doe@example.com"]),
    content=EmailContent(
        var_from="My App <no-reply@yourdomain.com>",
        subject="Welcome aboard!",
        body=[
            BodyPart(content_type=BodyContentType.HTML, content="<h1>Hello!</h1><p>Thanks for signing up.</p>"),
            BodyPart(content_type=BodyContentType.PLAINTEXT, content="Hello! Thanks for signing up."),
        ],
    ),
)

with ElasticEmail.ApiClient(configuration) as api_client:
    emails = ElasticEmail.EmailsApi(api_client)
    try:
        result = emails.emails_transactional_post(message)
        print(f"Sent. TransactionID: {result.transaction_id}, MessageID: {result.message_id}")
    except ApiException as e:
        print(f"Elastic Email API error {e.status}: {e.body}")

The sender field is var_from because from is a reserved word in Python. The address must use a domain you've verified in your Elastic Email account.

Send from a template with merge fields

message = EmailTransactionalMessageData(
    recipients=TransactionalRecipient(to=["john.doe@example.com"]),
    content=EmailContent(
        var_from="My App <no-reply@yourdomain.com>",
        template_name="welcome-template",
        merge={"firstname": "John"},
    ),
)

with ElasticEmail.ApiClient(configuration) as api_client:
    ElasticEmail.EmailsApi(api_client).emails_transactional_post(message)

Proxy, timeouts and retries

configuration.proxy = "http://myProxyUrl:80/"
configuration.retries = 3

# Per-request timeout in seconds, or a (connect, read) tuple
emails.emails_transactional_post(message, _request_timeout=(5, 30))

More examples

More complete, runnable samples are in the Elastic Email examples repository. It covers transactional email, SMTP, webhooks, inbound email, contacts and serverless platforms across 20+ languages and frameworks.

• 🐍 Python examples
• 📂 All examples

Authentication

API limits

• Up to 20 concurrent connections per account
• A hard timeout of 600 seconds per request

API reference

All URIs are relative to https://api.elasticemail.com/v4. The SDK covers 114 endpoints across 16 API classes: CampaignsApi, ContactsApi, DomainsApi, EmailsApi, EventsApi, FilesApi, InboundRouteApi, ListsApi, SecurityApi, SegmentsApi, StatisticsApi, SubAccountsApi, SuppressionsApi, TemplatesApi, VerificationsApi and WebhookApi.

Models

Tests

pip install -r requirements.txt -r test-requirements.txt
pytest

Versioning

The SDK follows the Elastic Email API v4. Package versions and release notes are listed on PyPI and in GitHub Releases.

Contributing

Contributions are welcome! Most of this SDK is generated from the Elastic Email OpenAPI specification, so please read CONTRIBUTING.md before opening a pull request.

• 🐛 Report a bug
• 💡 Request a feature
• 🔒 Report a security issue

This project follows the Contributor Covenant Code of Conduct.

Support

• 💬 Chat with support on elasticemail.com (preferred)
• 📚 API documentation
• 🧪 Examples repository
• 🐛 GitHub issues, for bugs in this SDK only

License

Released under the MIT License. Copyright © 2021–2026 Elastic Email.