Home

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

• 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

Sending Email

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

Message Management

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

Configuration

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

Account Management

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

Analytics

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

Reference

• Error Handling — Exception types and how to handle them
• Postmark API Reference
• GitHub Repository