emercury-smtp-sdk 1.0.1

Official Python SDK for the Emercury SMTP API

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="[e-mail]", name="Example"),
    to=EmailAddress(email="[e-mail]"),
    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.