# Set Up Postmark

> Postmark keeps transactional and broadcast email separate. Connect Postmark with server and account tokens, use a Broadcast Message Stream for newsletters and marketing email, and configure one webhook endpoint for bounce and complaint events.

- 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-08-24
- 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, the correct message stream, 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 the correct stream for the email you plan to send.

- **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.
- **A message stream ID:** use a Broadcast Message Stream for newsletters, product updates, promotions, and other marketing email.
- **Permission to add webhooks:** you need this permission so Postmark can send bounce and spam complaint events back to Mailrith.

Postmark uses the server's default Transactional Message Stream when no stream ID is provided. Do not leave the Mailrith stream field blank when the connection will send newsletters or other marketing email.

## 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:** enter the Broadcast Message Stream ID for newsletters and other marketing email. Although the field is optional, leaving it blank makes Postmark use the server's default Transactional Message 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. For newsletters, product updates, promotions, and other marketing email, open an existing **Broadcast** stream or click **Create Message Stream**, enter a clear name, choose **Broadcast** as the type, and create the stream.
7. Open the Broadcast Message Stream and copy the stream ID shown by Postmark. If you leave the Mailrith field blank, Postmark uses the server's default Transactional Message Stream instead.
8. Return to [Email Delivery Connections](https://mailrith.com/docs/email-delivery-connections.md) in Mailrith, click **Create Connection**, and choose **Postmark**.
9. Enter the Postmark server token, account token, Broadcast Message Stream ID, From name, verified From email, and the workspaces that may use this connection.
10. 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 delivered, 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 same Broadcast Message Stream whose ID you entered in the Mailrith connection.
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 delivery, bounce, and spam complaint events. Delivery events let Mailrith resolve an email whose outcome was unknown, while bounce and complaint events protect future sends.
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.