← Back to Documentation

Newsletters & Email

Setting up Postmark to work with Roe

Roe has a full featured newsletter system that supports free and paid members. Members can sign up with just their name/email, no password required.

Before Postmark

  1. You’ll need to enable the Members feature, go to: Admin → Settings and click ENABLE MEMBERS. You will then set up Members and there you can enable Newsletters which turns on Postmark in Roe.
  2. You’ll want to make sure that you’ve added Author Email to: Admin → Settings → site.yml. This is the email address that will be used by Postmark.

1. Basic Postmark Setup

Postmark has good documentation. Use this article to get your account set up correctly:
Getting started with Postmark. This ensures that your emails are delivered reliably. Make sure to verify the email address you’ve set in Roe as your Author Email: Admin → Settings → site.yml

  1. Create a new Server or use the defaults created with your account (you can rename them)
  2. Postmark
  3. Go to Servers → Open your server → API Tokens
  4. Click the token to copy it
    • You’ll need to paste this into Roe’s settings.

2. Connect Postmark to Roe

  1. Go to: Admin → Settings → postmark.yml
  2. Paste your Server API Token
  3. Click “Save Configuration”
  4. You’ll see a green confirmation if successful

3. Configure Webhooks

Webhooks tell Roe when emails are delivered, bounce, or are marked as spam. We recommend testing webhooks on a live URL/server.

  1. In Postmark, go to Postmark Server → Choose your Broadcast Stream → Settings → Webhooks
  2. Click “Add webhook”
  3. Copy the webhook URL shown in Roe’s Postmark settings
  4. Paste it into Postmark: Webhook URL
  5. Enable these events:
    • ✅ Delivery (optional, for logging)
    • ✅ Bounce (required)
      • ✅ include message content
    • ✅ Spam Complaint (required)
      • ✅ include message content
  6. Click Send Test to make sure things are set up correctly
  7. Save the webhook
  8. You only need to do this for Broadcast Stream.

If all seems well, the indicator at the top of the page will be green and say Connected.