Emercury SMTP SDK for Python

The official Python client for sending transactional email and reading outbound delivery statistics through the stable Emercury SMTP API.

Installation

pip install emercury-smtp-sdk

Send an email

import os
import uuid

from emercury_smtp_sdk import (
    ApiClient,
    Configuration,
    EmailAddress,
    EmailApi,
    EmailContentPart,
    EmailContentType,
    SendEmailRequest,
)

configuration = Configuration()
configuration.api_key["ApiTokenAuth"] = os.environ["EMERCURY_API_TOKEN"]

email = SendEmailRequest(
    var_from=EmailAddress(email="sender@example.com", name="Example"),
    to=EmailAddress(email="recipient@example.net"),
    subject="Hello from Emercury",
    contents=[EmailContentPart(
        content_type=EmailContentType.TEXT_SLASH_PLAIN,
        content="Your transactional email is ready.",
    )],
)

with ApiClient(configuration) as api_client:
    result = EmailApi(api_client).send_email(
        email,
        idempotency_key=str(uuid.uuid4()),
    )

Use a unique idempotency key when a send may be retried. The same key and normalized payload return the original response for 24 hours; reusing a key with a different payload returns 409 Conflict.