poststack 0.5.0

Official Python SDK for the PostStack Email API

PostStack Python SDK

Official Python SDK for the PostStack Email API — an EU-hosted, GDPR-compliant email API for Python with sync and async clients, full type hints, and drop-in compatibility with Django, FastAPI, Flask, and Starlette. Up to 75% cheaper than Resend, SendGrid, and Postmark.

Docs: poststack.dev/docs/sdk.

Installation

pip install poststack

Requires Python 3.10+.

Quick start

from poststack import PostStack

client = PostStack(api_key="sk_live_...")

result = client.emails.send({
    "from": "[e-mail]",
    "to": ["[e-mail]"],
    "subject": "Hello from PostStack",
    "html": "<p>Welcome!</p>",
})

print(result["id"])

Async usage

import asyncio
from poststack import AsyncPostStack

async def main():
    client = AsyncPostStack(api_key="sk_live_...")
    try:
        result = await client.emails.send({
            "from": "[e-mail]",
            "to": ["[e-mail]"],
            "subject": "Hello from PostStack",
            "html": "<p>Welcome!</p>",
        })
        print(result["id"])
    finally:
        await client.aclose()

asyncio.run(main())

Or use it as an async context manager:

async with AsyncPostStack(api_key="sk_live_...") as client:
    result = await client.emails.send({...})

Error handling

Any non-2xx response raises PostStackError:

from poststack import PostStack, PostStackError

client = PostStack(api_key="sk_live_...")

try:
    client.emails.send({"from": "[e-mail]", "to": ["[e-mail]"], "subject": "hi"})
except PostStackError as e:
    print(e.status_code, e.error, e.request_id)

Configuration

client = PostStack(
    api_key="sk_live_...",
    base_url="https://api.poststack.dev",  # default
    timeout=30.0,                           # default (seconds)
)

Override timeout per call:

client.emails.send({...}, timeout=60.0)

Resources

• client.emails — send, get, list, cancel, reschedule, batch, events, insights
• client.domains — create, list, get, verify, update, delete, DMARC
• client.contacts — CRUD, import, export, unsubscribe
• client.contact_properties — custom properties
• client.segments — create, list, get, update, delete, contacts, preview
• client.templates — CRUD, publish, duplicate, presets
• client.webhooks — CRUD, test, deliveries, replay
• client.broadcasts — CRUD, send, test, variants
• client.suppressions — list, add, remove
• client.api_keys — CRUD
• client.mailboxes — CRUD, aliases, password
• client.subscription_topics — topics + contact subscriptions
• client.workflows — CRUD, steps, activate, pause, trigger
• client.signup_forms — CRUD, submit
• client.email_validations — validate, validate_batch

Links

• PostStack — EU-hosted email API
• API documentation
• Pricing · Compare providers
• Migrate from Resend · from SendGrid · from Postmark
• Status · Security · DPA

License

MIT — see LICENSE.