---
name: postmark-00ced0e81ff7
description: Use when working with Postmark email platform - routes to specific sub-skills for sending emails, processing inbound email, managing templates, or configuring webhooks.
license: MIT
metadata:
  author: postmark
  version: "1.0.0"
---

# 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 outbound webhooks for delivery, bounce, open, click, spam complaint, and subscription change events — including endpoint verification, per-webhook statistics, and retry behavior |
| **Best practices** | `postmark-email-best-practices` | Deliverability setup, compliance (CAN-SPAM/GDPR/CASL), email design, list management, testing, and sending reliability |

### Outbound and inbound webhooks are different systems

`postmark-webhooks` covers **outbound** event webhooks; `postmark-inbound` covers **inbound** email webhooks. They run on separate infrastructure and have **different retry schedules** — do not apply one to the other:

| | Outbound webhooks (`postmark-webhooks`) | Inbound webhooks (`postmark-inbound`) |
|---|---|---|
| Retries | Up to **9** retries over ~**72 minutes** (3 standard + 6 backoff) | Up to **10** retries over ~**10.5 hours** |
| Retried on | 5xx, 408, 429, network timeouts only — every other 4xx is permanent | Any non-200 response |

Endpoint verification and per-webhook statistics are outbound features — see `postmark-webhooks`.

## 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`
- **"Verify a webhook endpoint" / "my webhook is unverified"** → `postmark-webhooks`
- **"Webhook statistics / failure rate / why is my webhook paused"** → `postmark-webhooks`
- **"Webhook retries"** → `postmark-webhooks` (outbound events) or `postmark-inbound` (inbound email)
- **"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](https://account.postmarkapp.com/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

- [Postmark Developer Docs](https://postmarkapp.com/developer)
- [API Reference](https://postmarkapp.com/developer/api/overview)
- [Postmark API for LLMs](https://postmarkapp.com/llms.txt)
- [Postmark Dashboard](https://account.postmarkapp.com)


---
Source attribution: ActiveCampaign
Original project: https://github.com/ActiveCampaign/postmark-skills/blob/269553ee297376a3011694caec88f0f3c6bce4aa/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Dave AI.

## Upstream license notice

MIT License

Copyright (c) 2025 ActiveCampaign, LLC

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Dave AI resource metadata

Creator / publisher: ActiveCampaign
Original project: https://github.com/ActiveCampaign/postmark-skills/blob/269553ee297376a3011694caec88f0f3c6bce4aa/SKILL.md
Attribution basis: Source repository record

Fields of work: Marketing
Roles: Content Marketer, Email Marketer, Growth Marketer
Specialties: API
Tools: Postmark
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: 77c675da23a82f332badc26a28c7ac775eaadc7a75f37421bec951c475f1bed5