Set up Postmark

Before you start

Before connecting Postmark to Mailrith, have the following ready in your Postmark account:

• An active Postmark server. Each server in Postmark has its own API token and message streams. Decide which server should back this Mailrith connection before you begin.
• A verified sender signature or domain. The From email you enter in Mailrith must be a verified sender signature, or the domain must be verified in the Postmark server you are connecting to.
• The server API token. This is found in Postmark under your server's settings. Note that this is the server token, not the account-level API token — they are different credentials with different scopes.

Mailrith fields

When creating a Postmark connection in Mailrith, fill in the following fields:

• Server API Token: the token from your Postmark server settings page. This authorizes Mailrith to send through that specific server.
• Stream ID (optional): if your Postmark server uses multiple message streams, enter the stream ID here to route Mailrith emails through a specific stream. Leave blank to use the server's default outbound stream.
• From name: the display name in the recipient's inbox — for example, "Acme Newsletter".
• From email: the email address in the From field. Must match a verified sender signature in the Postmark server.

Postmark setup

1. In Postmark, navigate to your server and go to API Tokens. Copy the server token.
2. In Mailrith, create a new connection and select Postmark. Enter the server token and optionally a stream ID if you use non-default streams.
3. Enter the From name and From email, then save the connection.
4. Click Send test email to verify the credentials and confirm email arrives in an inbox.

Webhooks and test send

Postmark sends bounce and spam complaint events to a single unified endpoint. To configure it:

1. In Mailrith, open the connection row and click View webhooks. Copy the webhook URL shown.
2. In Postmark, navigate to your server, then go to Webhooks (under the message stream you are using).
3. Add a new webhook with the Mailrith URL and enable the Bounce and Spam Complaint event types.
4. Save the webhook in Postmark, then send a Mailrith test email to confirm the full setup is operational.

If you use multiple Postmark streams, make sure the webhook is configured on the same stream as the one specified in the Mailrith connection's Stream ID field — events from a different stream will not match Mailrith's expectations.