Setup

The setup process for Broadcast is straightforward and involves a few simple steps.

Step 1: Create your admin account

When you first access your Broadcast installation, you’ll be greeted with a split-screen onboarding page. Fill in your name, email address, and password to create the admin account.

Note: Future versions of Broadcast will support multiple administrative users. For the time being, only one user is supported.

Step 2: Create your first channel

Channels are like mailing lists — they help you organize subscribers and send targeted campaigns. Give your first channel a descriptive name like “Newsletter” or “Product Updates”.

Step 3: Confirm your domain

Broadcast will auto-detect your server’s IP address and domain. Confirm that the domain shown matches the URL where you installed Broadcast.

Step 4: Configure sender details

After completing the onboarding wizard, you’ll land on the dashboard. The Setup Required checklist in the bottom-right corner shows what’s left to configure before you can send emails.

Navigate to Settings → Sender Details to configure:

• Sender name — The display name recipients see (e.g., “John from Acme”)
• Sender email — The “From” email address (e.g., [email protected])
• Physical address — Recommended for CAN-SPAM and GDPR compliance
• Email footer — Added to every broadcast and sequence email (includes an unsubscribe link by default)

Step 5: Add an email server

Navigate to Settings → Email Servers and click Add email server. You’ll see three options:

Guided Setup (Recommended)

The easiest option. Select your email provider (Postmark, AWS SES, SendGrid, or Mailgun), paste your API key, and Broadcast will automatically configure domains, senders, and webhooks.

Manual Setup

For advanced users or providers not supported by Guided Setup (Resend, SMTP.com, Inboxroad, or custom SMTP). You’ll configure SMTP or API settings manually.

Test Server

Requires a license key. Provides a test email server for verifying your setup without sending real emails.

Email Server Delivery Methods

Broadcast supports two delivery methods:

SMTP Delivery

Traditional SMTP delivery works with all email service providers. You’ll need:

• SMTP server address and port
• SMTP username and password
• Authentication type (Plain, Login, or CRAM-MD5)

API Delivery

For improved performance and better error handling. Supported for:

• AWS SES — Uses AWS SDK for direct API sending
• Postmark — Uses Postmark’s REST API with message stream support
• SendGrid — Uses SendGrid’s v3 API with domain authentication
• Mailgun — Uses Mailgun’s API with per-domain webhook tracking

API delivery provides faster sending, better error messages, and reduced infrastructure requirements (no SMTP ports needed).

Next Steps

Once your channel is configured with sender details and at least one email server, you’re ready to:

• Add subscribers to your channel
• Send your first broadcast
• Create an email sequence
• Set up webhooks for delivery tracking