> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sendpost.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Postmark Integration

> Connect your Postmark account to SendPost for unified email management, template-based sending, and event tracking via Message Streams.

SendPost's Postmark integration allows you to use your existing Postmark account as a **Third-Party Sending Provider (TPSP)**. This means you can:

* Send emails through Postmark using SendPost's API with **templates** (Postmark Templates API)
* Use a **Message Stream** of your choice (transactional, broadcast, etc.) configured at setup
* Receive and process Postmark events (opens, clicks, deliveries, bounces, spam complaints) in SendPost
* View all email analytics in one centralized dashboard
* Apply SendPost's intelligent routing and throttling to your Postmark traffic

***

## Why Use Postmark with SendPost?

| Feature                  | Postmark Alone | Postmark + SendPost                               |
| ------------------------ | -------------- | ------------------------------------------------- |
| Multiple ESP management  | ❌              | ✅ Unified dashboard for all providers             |
| Cross-provider analytics | ❌              | ✅ Compare performance across ESPs                 |
| Advanced throttling      | Basic          | ✅ Per-provider rate limiting (Gmail, Yahoo, etc.) |
| Failover routing         | ❌              | ✅ Automatic fallback to other providers           |
| Centralized event logs   | ❌              | ✅ All events in one place                         |
| Sub-account management   | Limited        | ✅ Flexible sub-account hierarchy                  |

***

## What's Covered in This Guide

<CardGroup cols={2}>
  <Card title="Setting Up" icon="gear" href="/guides/postmark/setup">
    Configure Postmark as a provider with Server API Token and Message Stream selection
  </Card>

  <Card title="Sending Emails" icon="paper-plane" href="/guides/postmark/sending-emails">
    Send template-based emails through Postmark using the SendPost API
  </Card>

  <Card title="Event Types" icon="bell" href="/guides/postmark/event-types">
    Understand Postmark event types and how they map to SendPost
  </Card>

  <Card title="Analytics" icon="chart-line" href="/guides/postmark/analytics">
    Track opens, clicks, bounces, and configure rate limiting
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/guides/postmark/troubleshooting">
    Common issues, FAQs, and getting help
  </Card>
</CardGroup>

***

## Quick Reference

### Key Endpoints

| Purpose             | URL                              |
| ------------------- | -------------------------------- |
| Send Email (Native) | `POST /api/v1/subaccount/email/` |
| View Events         | SendPost Dashboard → Events      |

### Setup Checklist

<Steps>
  <Step title="Get Postmark Server API Token">
    Create or copy your Server API Token from Postmark
  </Step>

  <Step title="Add Provider">
    Add Postmark provider in SendPost (type: Postmark), enter token
  </Step>

  <Step title="Fetch and Select Message Stream">
    Click "Fetch message streams" and select one stream (e.g. outbound)
  </Step>

  <Step title="Use the auto-created IP Pool">
    An IP pool is auto-created when the provider is saved (100% to Postmark); find it via profile icon (top right) → IP Pools
  </Step>

  <Step title="Whitelist Domain (optional)">
    Optional: whitelist your sending domain in SendPost to enable domain-level stats for Postmark
  </Step>

  <Step title="Test">
    Send a test email with `ippool` and `tpspTemplate` (template required for Postmark)
  </Step>

  <Step title="Confirm Events">
    Confirm events appear in SendPost analytics (PM\* event types)
  </Step>
</Steps>