emercury-smtp-sdk 1.0.0

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.

API reference

• Email API
• Statistics API
• Models

All requests default to https://api.smtp.emercury.net. Set Configuration.host when a different endpoint is required.

This package is generated from the official Emercury SMTP OpenAPI contract. Generated client code and reference documentation should not be edited manually.