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.

postmark