Postmark

Overview

Groundhogg integrates with Postmark to provide ultra-fast, reliable delivery of transactional and marketing emails. This guide walks you through installing the integration, connecting your Postmark API credentials, and configuring bounce and complaint handling.

How Fast Is Postmark?

Postmark is designed for speed and delivers most emails in under a second. Groundhogg’s integration typically sends up to 500 emails per second, depending on your hosting environment and API limits.

Install the Integration

You can install the Postmark integration using the Groundhogg Helper plugin or manually upload the plugin files. Once the integration is installed, Postmark settings will appear in Groundhogg » Settings » Email.

📄 Installation Guide

Get Your API Credentials

1. Log in to your Postmark Dashboard.
2. Go to Servers and select the server you want to use.
3. Click on the API Tokens tab.
4. Copy the Server API Token.

If you haven’t created a server yet, create one and associate it with your verified sending domain before proceeding.

Connect Groundhogg to Postmark

1. In your WordPress admin, go to Groundhogg » Settings » Email.
2. Scroll down to the Postmark settings section.
3. Paste your Server API Token into the field provided.
4. Save your changes—the page will reload.
5. Click Test API Connection to confirm the setup is working.

Groundhogg can now use Postmark to send emails through your selected server.

Bounce and Complaint Handling

To automatically manage bounces and spam complaints, set up a webhook in Postmark:

1. In your Postmark server, go to Settings » Webhooks.
2. Click Add Webhook and enter the Webhook URL from Groundhogg » Settings » Email » Postmark. It will look like: https://yoursite.com/wp-json/gh/v3/postmark/listener?webhook_key=foobar
3. Enable the following webhook event types:
   • Bounce
   • Spam Complaint
   • Subscription Change
4. Save your webhook settings.

Postmark will now notify Groundhogg of bounce and complaint events, keeping your list clean and compliant.

Tell Groundhogg To Use Postmark

Groundhogg will not use Postmark automatically. You must specify which types of email should be sent through Postmark.

At the top of Groundhogg » Settings » Email, choose Postmark for:

• Marketing Email
• Transactional Email
• WordPress Email

Disable Link Tracking (Optional)

To avoid conflicts with Groundhogg’s built-in tracking:

1. Go to your Postmark server settings.
2. Under Track Opens and Track Links, disable both options.
3. Save changes.

Disabling tracking ensures Groundhogg remains in full control of engagement tracking and avoids duplicated analytics.