Docs Providers

Postmark

Configure Postmark as your email provider.

About Postmark

Postmark is a transactional email service known for exceptional deliverability and detailed analytics. It focuses exclusively on transactional email, not marketing.

Website: postmarkapp.com

Prerequisites

  1. A Postmark account
  2. A verified sender signature
  3. A server token

Getting Your Server Token

  1. Log in to Postmark
  2. Select your server (or create one)
  3. Go to API Tokens tab
  4. Copy the Server API Token

Configuration

Add Postmark in mailshit:

  1. Go to Settings > Providers
  2. Click Add Provider
  3. Select Postmark
  4. Enter the following:
FieldDescriptionExample
Server TokenYour Postmark server tokenabc123-def456-...
From EmailVerified sender emailhello@yourdomain.com
From NameDisplay name (optional)Your Company
  1. Click Save

Sender Signatures

Postmark requires verified sender signatures:

Single Email Address

  1. Go to Sender Signatures
  2. Click Add Sender Signature
  3. Choose I want to send with a single email address
  4. Enter the email and click Create Signature
  5. Confirm via the verification email

Domain

For using any address @yourdomain.com:

  1. Go to Sender Signatures
  2. Click Add Sender Signature
  3. Choose I want to send with an entire domain
  4. Add the required DNS records
  5. Click Verify

Free Trial

Postmark offers:

  • 100 free test emails
  • $75 credit on first purchase
  • No monthly minimums

Message Streams

Postmark uses message streams to separate email types:

  • Transactional - Receipts, notifications, etc.
  • Broadcast - Newsletters (requires separate stream)

mailshit uses the transactional stream by default.

Example Response

{
  "success": true,
  "type": "sent",
  "messageId": "pm_abc123..."
}

Best Practices

  1. Verify your domain for better deliverability
  2. Use DKIM (enabled by default with domain verification)
  3. Monitor delivery stats in Postmark’s dashboard
  4. Keep bounce rates low to maintain good reputation

Deliverability Features

Postmark provides:

  • 45-day message retention
  • Detailed delivery tracking
  • Bounce management
  • Spam complaint tracking
  • Real-time webhooks

Troubleshooting

“You do not have access to send with the specified sender”

  • Verify your sender signature in Postmark
  • Ensure the from email matches a verified address

“Inactive recipient”

  • The recipient has been suppressed due to bounces
  • Check Postmark’s Suppressions list

“Server token not found”

  • Verify the token is correct
  • Make sure you’re using a Server token, not Account token