Official Postmark Python SDK Wiki

This wiki provides guides and examples for using the postmark-python library — a Python SDK for the Postmark email delivery API. The library is async-first, with a synchronous wrapper available as of v0.3.0 for scripts, Flask apps, and other non-async contexts.

• Getting Started — Installation, setup, and your first email
• Sync Client — Use the library without async/await (scripts, Flask, Jupyter)
• Jupyter Notebooks — Using the SDK in a notebook environment
• Django Backend — Drop-in EMAIL_BACKEND for Django 4.2–6.1

• Email Sending — Simple sends, batch, bulk (and listing bulk requests), attachments, tracking, and custom headers
• Templates — Send with templates, manage templates

• Messages — Retrieve outbound and inbound messages
• Bounces — Track and manage bounces
• Suppressions — Manage suppression lists
• Trigger Inbound Rules — Create and manage inbound rule triggers

• Server — View and update your server's settings
• Servers — Manage multiple servers (account-level)
• Message Streams — Create and manage message streams
• Webhooks — Configure, verify and monitor webhooks

• Domains — Manage sending domains
• Sender Signatures — Manage sender email addresses
• Data Removal — GDPR data removal requests

• Stats — Retrieve delivery, open, click, and bounce statistics

• Error Handling — Exception types and how to handle them
• Upgrading to 0.5.0 — What changed, and what to check when you upgrade from 0.4.x
• Postmark API Reference
• GitHub Repository