# Set Up Postmark

> Postmark is a strong choice for reliable transactional-style delivery — connect it to Mailrith with a server token, optionally specify a message stream, and configure one webhook endpoint for event tracking.

- Human page: https://mailrith.com/docs/setup-postmark
- Category: Campaigns & Delivery
- Reading time: 8 min read

## What this guide covers
Connect a Postmark server to Mailrith using a server API token, with optional stream routing and a unified webhook for bounce and complaint events.

## Sections
- Before You Start
- Mailrith Fields
- Postmark Setup
- Webhooks and Test Send

## Visual Reference
![Mailrith email delivery connections page showing connected providers with action controls.](https://mailrith.com/docs/screenshots/email-delivery-connections.png)

The Email Delivery Connections page lists every connected provider. From here you can add a new connection, send a test email, view webhook endpoints, and assign connections to workspaces.

## Before You Start

Postmark organizes sending around servers and message streams. Before connecting Postmark to Mailrith, decide which Postmark server and stream you want to send your Mailrith campaigns.

- **An active Postmark server:** Mailrith uses the server API token from this server.
- **A verified sender signature or domain:** the From email in Mailrith must be allowed by Postmark.
- **A server API token:** use the server token, not the account API token.
- **An optional message stream ID:** use this if you want Mailrith emails routed through a specific stream.
- **Permission to add webhooks:** needed so Postmark can send bounce and spam complaint events back to Mailrith.

If your Postmark account uses multiple streams, confirm which one is appropriate for marketing or lifecycle email before you create the connection.

## Mailrith Fields

In Mailrith, click [Email Delivery Connections](https://mailrith.com/docs/email-delivery-connections.md) in the left sidebar, click **Create Connection**, choose **Postmark** in **Select Email Delivery Service**, and enter these fields in **Connect Email Delivery Service**:

- **Connection name:** an internal label, such as "Postmark Newsletter Server".
- **Server API Token:** the token from the Postmark server settings.
- **Stream ID:** optional. Enter the stream ID only if you want to use a specific stream; otherwise leave it blank to use the default outbound stream.
- **From name:** the sender name subscribers see.
- **From email:** the verified sender address or an address on a verified domain.
- **Workspaces:** the Mailrith workspaces allowed to use this Postmark sender.

## Postmark Setup

1. Sign in to Postmark and open the account that should send Mailrith email.
2. If you already have a Postmark server for this sender, open it. If not, click **Create server**, give it a clear name such as **Mailrith Marketing** or **Acme Newsletter**, and create it.
3. Open the server and confirm the sender identity is ready. The From email you enter in Mailrith must be covered by a verified sender signature or by a verified domain inside Postmark.
4. Open the server's **API Tokens** area and copy the **Server API Token**. Use the token from the server, not a general account-level token.
5. Decide which Postmark message stream Mailrith should use. The default stream is commonly `outbound`. If your Postmark account has separate streams for broadcasts, lifecycle messages, or transactional email, open the correct stream and copy its stream ID.
6. Return to [Email Delivery Connections](https://mailrith.com/docs/email-delivery-connections.md) in Mailrith, click **Create Connection**, and choose **Postmark**.
7. Enter the Postmark server token, the optional stream ID, the From name, the verified From email, and the workspaces that may use this connection.
8. Click **Save**, then use **Send Test Email** from the connection row.

If the test send fails, check that the token came from the same Postmark server, the stream ID is spelled exactly as Postmark shows it, and the From email is covered by a verified sender signature or verified domain.

## Webhooks and Test Send

Postmark can send bounce and spam complaint events to Mailrith through one webhook URL.

1. In Mailrith, click **Email Delivery Connections**, click **Webhooks** on the Postmark connection, and copy the delivery-event webhook URL exactly.
2. In Postmark, open the same server that supplied the Server API Token.
3. Open the message stream used by the Mailrith connection. If you left the stream blank in Mailrith, use the default outbound stream.
4. Open the stream's webhook settings and create a new webhook.
5. Paste the Mailrith delivery-event URL as the webhook endpoint.
6. Enable bounce and spam complaint events. If Postmark offers extra delivery events, you may enable them for reporting, but bounce and spam complaint events are the most important for subscriber protection in Mailrith.
7. Save the webhook, then send another Mailrith test email or wait for the next small controlled send.

If Postmark uses a different stream than the one in Mailrith, events may not match the messages Mailrith sent. Keep the stream settings aligned.

## Related Guides
- [Email Delivery Connections](https://mailrith.com/docs/email-delivery-connections.md): Mailrith is provider-agnostic — you connect your own email delivery service and Mailrith handles campaign logic, subscriber targeting, and engagement tracking on top of it.
- [Broadcasts](https://mailrith.com/docs/broadcasts.md): Broadcasts are for newsletters, product launches, announcements, and any message that goes out once to selected subscribers — compose, target, test, and send or schedule from a single workflow.
- [Sequences](https://mailrith.com/docs/sequences.md): Sequences send a series of emails over time as subscribers progress through the steps — ideal for onboarding, nurture campaigns, and educational content that should unfold over days or weeks.