SendHog Python SDK

Send transactional email through SendHog with a domain-scoped API key. Native API plus SES-, Postmark-, Resend- and SendGrid-shaped migration clients, all using SendHog authentication and the same transport.

Python 3.11+. MIT licensed. Registry publication status is recorded in GitHub Releases; do not assume a version exists on PyPI until it is listed there as published.

Install

pip install sendhog-sdk

Before the first registry release, install the public source instead: pip install git+https://github.com/SendHog/sdk-python.git.

Send

import os
from sendhog import SendHog

client = SendHog(os.environ['SENDHOG_API_KEY'])
message = client.send({
    'from': 'hello@your-verified-domain.com',
    'to': 'recipient@example.com',
    'subject': 'Welcome',
    'html': '<h1>Welcome</h1>',
    'text': 'Welcome',
})
print(message['id'])

Your domain must be verified and approved for sending. Account allowances, recipient suppressions and other server-side controls still apply. Store API keys in your server's secret manager, not in source code.

Published templates

client.send({
    'from': 'hello@your-verified-domain.com',
    'to': 'recipient@example.com',
    'template': {'id': 'welcome', 'version': 1, 'variables': {'name': 'Alex'}},
})

IDs/slugs belong to your sending domain; omit version for latest published. Template and inline html/text are mutually exclusive. HTML variables are escaped; missing variables fail before dispatch. No arbitrary JSX or JavaScript execution.

Read retained mail

page = client.messages.list({'limit': 20})
detail = client.messages.get(page['data'][0]['id'])

Requires email.read. This is a SendHog extension, not provider inbox/API emulation. No automatic send retries; inspect failures before resubmitting an email.

Migration modules

All use SendHog API keys/endpoints, not upstream credentials or SigV4. Supported subset: text/HTML, up to 50 total recipients, cc/bcc/reply-to (native reply_to); native/Resend-style requests also support published SendHog templates. No raw MIME, attachments, batch, scheduling, tracking or complete upstream SDK compatibility. Documentation.

Source and development

This is a reproducible release mirror of SendHog's canonical SDK source, not an independently maintained API fork. SOURCE.json records the exact source revision, contract hash and exported file digests. Public contract/ fixtures are synthetic; no service source, account data or credentials are exported. File issues here; maintainers update the canonical generator/runtime and re-export the release.

python -m pip install . build twine
python scripts/verify-source.py
python -m unittest discover -s tests -p '*_test.py'
python -m build
python -m twine check dist/*

CI runs on pushes/PRs. The manual publish.yml workflow publishes a matching vX.Y.Z tag with PyPI trusted publishing in the pypi GitHub environment. An authorized PyPI account must first configure the pending/existing publisher for sendhog-sdk, SendHog/sdk-python, workflow publish.yml, environment pypi. No token is stored here.