postmark

Use when working with Postmark email platform - routes to specific sub-skills for sending emails, processing inbound email, managing templates, or configuring webhooks.

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

FeatureSkillUse When
Sending emailspostmark-send-emailSending transactional or broadcast emails — single, batch, bulk, or with templates
Inbound processingpostmark-inboundProcessing incoming emails via webhooks, building reply-by-email, email-to-ticket, or document extraction
Template managementpostmark-templatesCreating, editing, or sending with Postmark's server-side Handlebars templates and layouts
Webhookspostmark-webhooksSetting up webhooks for delivery, bounce, open, click, spam complaint, and subscription change events
Best practicespostmark-email-best-practicesDeliverability 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:

TokenHeaderScope
Server TokenX-Postmark-Server-TokenSending emails, templates, bounces, webhooks, message streams
Account TokenX-Postmark-Account-TokenManaging servers, domains, sender signatures

Get your Server API Token from Postmark Servers.

SDK Installation

Detect the project language and install the appropriate SDK:

FileLanguageInstall Command
package.jsonNode.js / TypeScriptnpm install postmark
requirements.txt / pyproject.tomlPythonpip install postmarker
GemfileRubygem install postmark
composer.jsonPHPcomposer require wildbit/postmark-php
*.csproj / *.sln.NETdotnet add package Postmark

Message Streams

Postmark separates email by intent into Message Streams:

StreamValuePurpose
Transactionaloutbound1:1 triggered emails (welcome, password reset, receipts) — default
BroadcastbroadcastMarketing, newsletters, announcements

Never mix transactional and broadcast email in the same stream — it damages deliverability.

Resources