Postmark Skills
Postmark is a transactional email platform built for developers, with 15+ years of deliverability expertise. These skills teach AI agents how to use the Postmark API effectively.
Sub-Skills
| Feature | Skill | Use When |
|---|---|---|
| Sending emails | postmark-send-email | Sending transactional or broadcast emails — single, batch, bulk, or with templates |
| Inbound processing | postmark-inbound | Processing incoming emails via webhooks, building reply-by-email, email-to-ticket, or document extraction |
| Template management | postmark-templates | Creating, editing, or sending with Postmark's server-side Handlebars templates and layouts |
| Webhooks | postmark-webhooks | Setting up webhooks for delivery, bounce, open, click, spam complaint, and subscription change events |
| Best practices | postmark-email-best-practices | Deliverability setup, compliance (CAN-SPAM/GDPR/CASL), email design, list management, testing, and sending reliability |
Quick Routing
- "Send an email" →
postmark-send-email - "Send a batch of emails" →
postmark-send-email - "Send using a template" →
postmark-send-email(template section) orpostmark-templates(to create/manage templates) - "Handle incoming email" →
postmark-inbound - "Process inbound webhooks" →
postmark-inbound - "Create an email template" →
postmark-templates - "Track deliveries/bounces/opens" →
postmark-webhooks - "Set up bounce handling" →
postmark-webhooks - "Set up SPF/DKIM/DMARC" →
postmark-email-best-practices - "Email compliance / GDPR / CAN-SPAM" →
postmark-email-best-practices - "Domain warm-up" →
postmark-email-best-practices - "List hygiene / suppression management" →
postmark-email-best-practices - "Design a transactional email" →
postmark-email-best-practices - "Test email safely" →
postmark-email-best-practices
Common Setup
Authentication
Postmark uses two types of API tokens:
| Token | Header | Scope |
|---|---|---|
| Server Token | X-Postmark-Server-Token | Sending emails, templates, bounces, webhooks, message streams |
| Account Token | X-Postmark-Account-Token | Managing servers, domains, sender signatures |
Get your Server API Token from Postmark Servers.
SDK Installation
Detect the project language and install the appropriate SDK:
| File | Language | Install Command |
|---|---|---|
package.json | Node.js / TypeScript | npm install postmark |
requirements.txt / pyproject.toml | Python | pip install postmarker |
Gemfile | Ruby | gem install postmark |
composer.json | PHP | composer require wildbit/postmark-php |
*.csproj / *.sln | .NET | dotnet add package Postmark |
Message Streams
Postmark separates email by intent into Message Streams:
| Stream | Value | Purpose |
|---|---|---|
| Transactional | outbound | 1:1 triggered emails (welcome, password reset, receipts) — default |
| Broadcast | broadcast | Marketing, newsletters, announcements |
Never mix transactional and broadcast email in the same stream — it damages deliverability.