SendGrid

Overview

Groundhogg integrates with SendGrid to deliver fast and reliable email at scale. This guide walks you through installing the integration, connecting your SendGrid API credentials, and enabling bounce and complaint handling.

How fast is SendGrid?

Groundhogg’s SendGrid integration can send up to 50 emails/second. The true speed will be dependent on factors like your PHP version, hosting, connection, etc.

Install the Integration

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

📄 Installation Guide

Get Your API Credentials

1. Log in to your SendGrid Dashboard.
2. Go to Settings » API Keys.
3. Click Create API Key.
4. Name the key something like “Groundhogg Integration.”
5. Choose Restricted Access and set Mail Send to full access.
6. Click Create & View and copy the API key.

Store the key in a secure place—you’ll need it for the next step.

Connect Groundhogg to SendGrid

1. In your WordPress admin, go to Groundhogg » Settings » Email.
2. Scroll down to the SendGrid settings.
3. Paste your SendGrid API key into the field provided.
4. Save your changes, and the page will reload.
5. Click Test API Connection to verify the API key works.

Groundhogg will now use SendGrid for all outgoing emails.

Bounce and Complaint Handling

To automatically mark contacts as bounced or unsubscribed based on SendGrid feedback, set up an event webhook in SendGrid:

1. In your SendGrid dashboard, go to Settings » Mail Settings.
2. Scroll to Event Webhook and click the gear icon.
3. Enable the following event types:
   • Bounced
   • Spam Report
   • Dropped
4. For the Post URL, copy the Webhook URL from the SendGrid settings (underneath where you entered the API key) in Groundhogg. It will look something like https://yoursite.com/wp-json/gh/v3/sendgrid/listener?webhook_key=foobar
5. Save your changes.

SendGrid will now send bounce and complaint feedback to Groundhogg and manage your list automatically.

Tell Groundhogg To Use SendGrid

Groundhogg will not use SendGrid automatically. You must select which types of email Groundhogg should send using SendGrid. At the top of Groundhogg » Settings » Email select SendGrid for the desired email types.

Disable Link Tracking (Optional)

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

1. Go to Settings » Tracking in your SendGrid dashboard.
2. Disable Click Tracking and optionally Open Tracking.
3. Save changes.

This ensures Groundhogg handles all engagement tracking for accurate reporting.