# Set Up Postmark

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

- Human page: https://mailrith.com/docs/setup-postmark
- Markdown page: https://mailrith.com/docs/setup-postmark.md
- Category: Campaigns & Delivery
- Reading time: 8 min read
- Last updated: 2026-07-13
- Related keywords: Set Up Postmark, Set Up Postmark documentation, Campaigns & Delivery, Campaigns & Delivery documentation, Mailrith documentation, Mailrith help, Before You Start, Mailrith Fields, Postmark Setup, Webhooks and Test Send, Email Delivery Connections, Broadcasts, Sequences

## AI Agent Notes
- Use this article as step-by-step Mailrith product guidance, not as legal, financial, or deliverability advice unless the article says so.
- Preserve exact Mailrith UI labels from the steps when explaining a workflow.
- Prefer Mailrith's product term Subscribers when referring to people on an email list.

## What this guide covers
Connect a Postmark server to Mailrith with server and account API tokens, optional stream routing, and one 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 services with action controls.](https://mailrith.com/docs/screenshots/email-delivery-connections.png)

The Email Delivery Connections page lists every connected service. From here you can add a connection, send a test email, view delivery-event links, and assign connections to workspaces.

## Before You Start

Postmark sends email through servers, sender identities, and message streams. Before you connect Postmark to Mailrith, choose the Postmark server and stream Mailrith should use to send your campaigns.

- **An active Postmark server:** Mailrith uses this server's API token to send email.
- **A verified sender signature or domain:** Postmark must allow the From email you enter in Mailrith.
- **A server API token:** Mailrith uses this token to send email through the selected Postmark server.
- **An account API token:** Mailrith uses this token to check that the From email or domain is verified in Postmark.
- **An optional message stream ID:** enter a stream ID only when you want Mailrith emails to use a specific stream.
- **Permission to add webhooks:** you need this permission so Postmark can send bounce and spam complaint events back to Mailrith.

If your Postmark account uses multiple streams, identify the stream 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:** enter an internal label, such as "Postmark Newsletter Server".
- **Server API Token:** paste the token from the Postmark server settings.
- **Account API Token:** paste the token from the Postmark account API token area. Mailrith uses it to confirm the From email or domain.
- **Stream ID:** optional. Enter the stream ID only if you want to use a specific stream; otherwise leave this field blank to use the default outbound stream.
- **From name:** enter the sender name subscribers see.
- **From email:** enter a verified sender address or an address on a verified domain.
- **Workspaces:** select the Mailrith workspaces that can 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 that server. If you do not have one, click **Create server**, give the server a clear name such as **Mailrith Marketing** or **Acme Newsletter**, and create the server.
3. Open the server and confirm the sender identity is ready. The From email you enter in Mailrith must match a verified sender signature or be on a verified domain inside Postmark.
4. Open the server's **API Tokens** area and copy the **Server API Token**.
5. Open the account API token area and copy the **Account API Token**. Mailrith needs this token only to check sender signatures and domains during setup.
6. 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.
7. Return to [Email Delivery Connections](https://mailrith.com/docs/email-delivery-connections.md) in Mailrith, click **Create Connection**, and choose **Postmark**.
8. Enter the Postmark server token, account token, optional stream ID, From name, verified From email, and the workspaces that may use this connection.
9. Click **Save**, then use **Send Test Email** from the connection row.

If the connection cannot be saved or the test send fails, check these settings: the server token is from the same Postmark server, the account token is copied correctly, the stream ID matches the spelling shown in Postmark, and the From email matches a verified sender signature or is on a 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 those events for reporting, but bounce and spam complaint events are the most important events 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 Mailrith connection, webhook events may not match the messages Mailrith sent. Keep the Postmark stream and the Mailrith stream setting aligned.

## Related Guides
- [Email Delivery Connections](https://mailrith.com/docs/email-delivery-connections.md): You connect your own email delivery service. Mailrith then manages subscribers, campaigns, follow-up, and reports while that service sends the emails.
- [Broadcasts](https://mailrith.com/docs/broadcasts.md): Use broadcasts for newsletters, product launches, announcements, and any message you send once to selected subscribers. Compose, target, test, and send or schedule the campaign in one workflow.
- [Sequences](https://mailrith.com/docs/sequences.md): Sequences send a series of emails over time as subscribers move through the steps. Use sequences for onboarding, nurture campaigns, and educational content that should be sent over days or weeks.