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

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

Quick Setup

For providers without dedicated pages, see the setup instructions below.

Why Use ESP Webhooks?

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

Finding Your Webhook URLs

All webhook URLs are available in Settings → ESP Integrations:

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

Mailgun Setup

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 Settings → ESP Integrations
3. Enter the signing key in the Mailgun section

SendGrid Setup

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 Settings → ESP Integrations

5. Enter the verification key in the SendGrid section

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 → ESP Integrations
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 in the ESP Integrations 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