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) or postmark-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.
Resources
1---2name: postmark3description: Use when working with Postmark email platform - routes to specific sub-skills for sending emails, processing inbound email, managing templates, or configuring webhooks.4license: MIT5---6
7# Postmark Skills
8
9Postmark 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.
10
11## Sub-Skills
12
13| Feature | Skill | Use When |
14|---------|-------|----------|
15| **Sending emails** | `postmark-send-email` | Sending transactional or broadcast emails — single, batch, bulk, or with templates |
16| **Inbound processing** | `postmark-inbound` | Processing incoming emails via webhooks, building reply-by-email, email-to-ticket, or document extraction |
17| **Template management** | `postmark-templates` | Creating, editing, or sending with Postmark's server-side Handlebars templates and layouts |
18| **Webhooks** | `postmark-webhooks` | Setting up webhooks for delivery, bounce, open, click, spam complaint, and subscription change events |
19| **Best practices** | `postmark-email-best-practices` | Deliverability setup, compliance (CAN-SPAM/GDPR/CASL), email design, list management, testing, and sending reliability |
20
21## Quick Routing
22
23- **"Send an email"** → `postmark-send-email`
24- **"Send a batch of emails"** → `postmark-send-email`
25- **"Send using a template"** → `postmark-send-email` (template section) or `postmark-templates` (to create/manage templates)
26- **"Handle incoming email"** → `postmark-inbound`
27- **"Process inbound webhooks"** → `postmark-inbound`
28- **"Create an email template"** → `postmark-templates`
29- **"Track deliveries/bounces/opens"** → `postmark-webhooks`
30- **"Set up bounce handling"** → `postmark-webhooks`
31- **"Set up SPF/DKIM/DMARC"** → `postmark-email-best-practices`
32- **"Email compliance / GDPR / CAN-SPAM"** → `postmark-email-best-practices`
33- **"Domain warm-up"** → `postmark-email-best-practices`
34- **"List hygiene / suppression management"** → `postmark-email-best-practices`
35- **"Design a transactional email"** → `postmark-email-best-practices`
36- **"Test email safely"** → `postmark-email-best-practices`
37
38## Common Setup
39
40### Authentication
41
42Postmark uses two types of API tokens:
43
44| Token | Header | Scope |
45|-------|--------|-------|
46| **Server Token** | `X-Postmark-Server-Token` | Sending emails, templates, bounces, webhooks, message streams |
47| **Account Token** | `X-Postmark-Account-Token` | Managing servers, domains, sender signatures |
48
49Get your Server API Token from [Postmark Servers](https://account.postmarkapp.com/servers).
50
51### SDK Installation
52
53Detect the project language and install the appropriate SDK:
54
55| File | Language | Install Command |
56|------|----------|----------------|
57| `package.json` | Node.js / TypeScript | `npm install postmark` |
58| `requirements.txt` / `pyproject.toml` | Python | `pip install postmarker` |
59| `Gemfile` | Ruby | `gem install postmark` |
60| `composer.json` | PHP | `composer require wildbit/postmark-php` |
61| `*.csproj` / `*.sln` | .NET | `dotnet add package Postmark` |
62
63### Message Streams
64
65Postmark separates email by intent into **Message Streams**:
66
67| Stream | Value | Purpose |
68|--------|-------|---------|
69| **Transactional** | `outbound` | 1:1 triggered emails (welcome, password reset, receipts) — **default** |
70| **Broadcast** | `broadcast` | Marketing, newsletters, announcements |
71
72Never mix transactional and broadcast email in the same stream — it damages deliverability.
73
74## Resources
75
76- [Postmark Developer Docs](https://postmarkapp.com/developer)
77- [API Reference](https://postmarkapp.com/developer/api/overview)
78- [Postmark API for LLMs](https://postmarkapp.com/llms.txt)
79- [Postmark Dashboard](https://account.postmarkapp.com)