Skip to content

Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.

6.1 KB
Raw Blame

Postmark

Transactional email delivery service with fast delivery, templates, bounce management, and detailed analytics.

Capabilities

Integration Available Notes
API ✓ REST API for email sending, templates, bounces, stats
MCP - Not available
CLI ✓ postmark.js
SDK ✓ Node.js, Ruby, Python, PHP, Java, .NET, Go

Authentication

  • Type: Server Token (or Account Token for account-level ops)
  • Header: X-Postmark-Server-Token: {server_token} (server-level)
  • Header: X-Postmark-Account-Token: {account_token} (account-level)
  • Get key: API Tokens tab at https://account.postmarkapp.com/servers
  • Note: Server tokens are per-server; account tokens apply across all servers

Common Agent Operations

Send single email

POST https://api.postmarkapp.com/email

{
  "From": "[email protected]",
  "To": "[email protected]",
  "Subject": "Welcome!",
  "HtmlBody": "<html><body><p>Hello!</p></body></html>",
  "TextBody": "Hello!",
  "MessageStream": "outbound",
  "TrackOpens": true,
  "TrackLinks": "HtmlAndText"
}

Send with template

POST https://api.postmarkapp.com/email/withTemplate

{
  "From": "[email protected]",
  "To": "[email protected]",
  "TemplateId": 12345,
  "TemplateModel": {
    "name": "Jane",
    "action_url": "https://example.com/verify"
  },
  "MessageStream": "outbound"
}

Send batch emails

POST https://api.postmarkapp.com/email/batch

[
  {
    "From": "[email protected]",
    "To": "[email protected]",
    "Subject": "Notification",
    "TextBody": "Hello user 1"
  },
  {
    "From": "[email protected]",
    "To": "[email protected]",
    "Subject": "Notification",
    "TextBody": "Hello user 2"
  }
]

List templates

GET https://api.postmarkapp.com/templates?Count=100&Offset=0

Get template

GET https://api.postmarkapp.com/templates/{templateIdOrAlias}

Create template

POST https://api.postmarkapp.com/templates

{
  "Name": "Welcome Email",
  "Alias": "welcome",
  "Subject": "Welcome {{name}}!",
  "HtmlBody": "<html><body><p>Hello {{name}}</p></body></html>",
  "TextBody": "Hello {{name}}"
}

Get delivery stats

GET https://api.postmarkapp.com/deliverystats

List bounces

GET https://api.postmarkapp.com/bounces?count=50&offset=0&type=HardBounce

Activate bounce (reactivate recipient)

PUT https://api.postmarkapp.com/bounces/{bounceId}/activate

Search outbound messages

GET https://api.postmarkapp.com/messages/outbound?count=50&offset=0&[email protected]

Get outbound stats overview

GET https://api.postmarkapp.com/stats/outbound?fromdate=2025-01-01&todate=2025-01-31

Get open stats

GET https://api.postmarkapp.com/stats/outbound/opens?fromdate=2025-01-01&todate=2025-01-31

Get click stats

GET https://api.postmarkapp.com/stats/outbound/clicks?fromdate=2025-01-01&todate=2025-01-31

Get server info

GET https://api.postmarkapp.com/server

List suppressions

GET https://api.postmarkapp.com/message-streams/outbound/suppressions/dump

Create suppression

POST https://api.postmarkapp.com/message-streams/outbound/suppressions

{
  "Suppressions": [
    { "EmailAddress": "[email protected]" }
  ]
}

API Pattern

Postmark uses simple REST endpoints with PascalCase field names in request/response bodies. Authentication is via custom headers rather than Authorization. Pagination uses Count and Offset parameters. Email sending is synchronous with immediate delivery confirmation.

Key Metrics

Delivery Metrics

  • Sent - Total emails sent
  • Bounced - Bounce count by type (hard, soft, transient)
  • SpamComplaints - Spam complaint count
  • Opens - Open count and unique opens
  • Clicks - Click count and unique clicks

Bounce Types

  • HardBounce - Permanent delivery failure
  • SoftBounce - Temporary delivery failure
  • Transient - Temporary issue (retry)
  • SpamNotification - Marked as spam

Message Fields

  • MessageID - Unique message identifier
  • SubmittedAt - Submission timestamp
  • Status - Delivery status
  • Recipients - Recipient list

Parameters

Email Parameters

  • From - Sender address (must be verified)
  • To - Recipient (comma-separated for multiple)
  • Subject - Email subject
  • HtmlBody / TextBody - Email content
  • MessageStream - outbound (transactional) or broadcast
  • TrackOpens - Enable open tracking (boolean)
  • TrackLinks - None, HtmlAndText, HtmlOnly, TextOnly
  • Tag - Custom tag for categorization

Stats Parameters

  • fromdate - Start date (YYYY-MM-DD)
  • todate - End date (YYYY-MM-DD)
  • tag - Filter by tag

When to Use

  • Transactional emails (password resets, order confirmations, notifications)
  • Template-based email sending with dynamic variables
  • Monitoring email deliverability and bounce rates
  • Tracking email engagement (opens, clicks)
  • Managing email suppressions and bounces
  • High-reliability email delivery with fast performance

Rate Limits

  • 500 messages per batch request
  • 10 MB max per single message (including attachments)
  • 50 MB max per batch request
  • API rate limits vary by plan

Relevant Skills

  • emails
  • transactional-email
  • email-deliverability
  • onboarding-email

Structured template models

Use --model-json for nested template data, line-item arrays, numbers and booleans. The existing --model key:value,... shorthand remains available for simple strings; choose one input format per invocation.

node tools/clis/postmark.js email send-template --from [email protected] --to [email protected] --template receipt --model-json '{"customer":{"name":"Growth, Inc."},"items":[{"title":"Service: priority","quantity":2}],"paid":true}' --dry-run

The CLI requires a JSON object and preserves its nested value types in TemplateModel. Preview first; removing --dry-run sends the message. See the Postmark Templates API.