ESP Integrations

Broadcast integrates with popular email service providers (ESPs) to send emails and receive real-time delivery notifications. This page provides an overview of supported providers and their capabilities.

Supported Providers

Guided Setup (Recommended)

The easiest way to add an email server is via the Guided Setup wizard. Navigate to Settings → Email Servers, click Add email server, and choose Guided Setup. Select your provider and paste your API key — Broadcast will automatically configure domains, senders, and webhooks for you.

Guided Setup is available for Postmark, AWS SES, SendGrid, and Mailgun.

Quick Links

Full Documentation

• AWS SES Integration — Complete guide including automatic setup, suppression sync, and IAM configuration
• Postmark Integration — Setup guide with API delivery and message streams

Manual Setup

For providers without guided setup (Resend, SMTP.com, Inboxroad, or custom SMTP), use the Manual Setup option to configure SMTP settings directly. See the provider-specific instructions below.

Why Use ESP Webhooks?

While Broadcast can track opens and clicks natively, ESP webhooks provide additional benefits:

Finding Your Webhook URLs

Webhook URLs are shown on each email server’s detail page. Navigate to Settings → Email Servers and click on a server to view its webhook URL.

Each provider has a unique webhook URL that you’ll configure in your ESP’s dashboard.

Mailgun Setup

Guided Setup (Recommended)

Use the Guided Setup wizard for the easiest experience:

1. Navigate to Settings → Email Servers
2. Click Add email server → Guided Setup
3. Select Mailgun
4. Enter your Mailgun API key and select your region (US or EU)
5. Broadcast will automatically detect your verified domains, configure API delivery, and set up webhooks

Manual Webhook Setup

If you’re using SMTP delivery instead, configure webhooks manually:

1. Log into your Mailgun account
2. Navigate to Sending → Webhooks
3. For each event type, add your Broadcast webhook URL:

   https://your-domain.com/wh/mailgun

1. Select events to track:
   • Delivered
   • Opened
   • Clicked
   • Bounced (Permanent Failure)
   • Complained
   • Unsubscribed

Webhook Signing Key

For webhook verification:

1. In Mailgun, find your Webhook Signing Key in the dashboard
2. In Broadcast, go to your email server’s detail page
3. Enter the signing key

SendGrid Setup

Guided Setup (Recommended)

Use the Guided Setup wizard for the easiest experience:

1. Navigate to Settings → Email Servers
2. Click Add email server → Guided Setup
3. Select SendGrid
4. Enter your SendGrid API key
5. Broadcast will automatically configure API delivery, domain authentication, and event webhooks

Manual Webhook Setup

If you’re using SMTP delivery instead, configure webhooks manually:

1. Log into your SendGrid account
2. Navigate to Settings → Mail Settings → Event Webhook
3. Enter your webhook URL with your channel ID:

   https://your-domain.com/wh/sendgrid?broadcast_channel_id=YOUR_CHANNEL_ID

1. Select events to track:

   • Processed
   • Delivered
   • Opened
   • Clicked
   • Bounced
   • Spam Report
   • Unsubscribe

2. Enable Signed Event Webhook Requests

3. Copy the Verification Key

4. In Broadcast, go to your email server’s detail page

5. Enter the verification key

Resend Setup

1. Log into your Resend dashboard
2. Navigate to Webhooks
3. Click Add Webhook
4. Enter your Broadcast webhook URL:

   https://your-domain.com/wh/resend

1. Select events:

   • email.sent
   • email.delivered
   • email.bounced
   • email.complained
   • email.opened
   • email.clicked

2. Save your webhook configuration

SMTP.com Setup

Contact SMTP.com support to configure webhook callbacks to your Broadcast endpoint:

https://your-domain.com/wh/smtp_com

Inboxroad Setup

Inboxroad provides API-based sync for bounces and complaints:

1. In Broadcast, go to Settings → Email Servers
2. Edit your Inboxroad email server
3. Enable Inboxroad API Sync
4. Enter your Inboxroad API Token
5. Save the configuration

Manual Sync

To sync bounces and complaints from Inboxroad:

1. Go to Settings → Email Servers
2. Find your Inboxroad server
3. Click Sync Now

Auto-Suppression

When Broadcast receives bounce or complaint webhooks, it automatically:

1. Deactivates the subscriber — Prevents future email sends
2. Adds to global suppression — Blocks the email across all channels

This protects your sender reputation and ensures compliance with anti-spam regulations.

Troubleshooting

Webhooks Not Received

1. Verify the webhook URL is correct
2. Check that your Broadcast instance is publicly accessible (HTTPS)
3. Review your ESP’s webhook logs for delivery failures
4. Ensure firewalls aren’t blocking incoming webhook requests

Events Not Appearing

1. Check that the correct events are selected in your ESP
2. Verify the email server has the correct vendor selected in Broadcast
3. Look for errors on the email server’s detail page

Authentication Errors

1. Verify any signing keys or verification tokens are correct
2. Check that credentials haven’t expired
3. Regenerate keys if needed and update both sides

Next Steps

• AWS SES Integration — Full setup guide with automatic configuration
• Postmark Integration — Complete Postmark integration guide
• Email Metrics — Understanding tracking and analytics
• Suppression Lists — Managing email suppressions