How to Connect an Email Provider
Step 1: Choose a Provider
Amazon SES is the cheapest at volume, around $0.10 per thousand emails, with minimal hand holding. SendGrid and Mailgun cost more but bring better tooling and reputation management. Postmark is superb for transactional mail and strict about bulk marketing. Our guide on choosing an email provider compares them in detail.
Because the engine talks standard SMTP, the provider is swappable. Your contacts, messages, series, and history all stay put if you change providers later, you just update the SMTP settings on the sending domain.
Step 2: Verify Your Domain and Set Up Authentication
Use a subdomain for bulk sending, like mail.yourbrand.com, so your marketing reputation stays separate from your day-to-day business email. If the domain is new, plan on warming it: small volumes to engaged contacts first, growing week over week. The setup guides for SPF, DKIM, and DMARC cover each record.
Step 3: Add the Sending Domain to the Engine
alias@domain), and the provider's SMTP host, username, and password. Use port 465 for SSL or 587 for STARTTLS, both work.| Provider | SMTP host | Username | Password |
|---|---|---|---|
| SendGrid | smtp.sendgrid.net | apikey | your SendGrid API key |
| Mailgun | smtp.mailgun.org | postmaster@your-domain | Mailgun SMTP password |
| Postmark | smtp.postmarkapp.com | server token | server token |
| Amazon SES | email-smtp.us-east-1.amazonaws.com (region specific) | SES SMTP username | SES SMTP password |
| SMTP2GO | mail.smtp2go.com | SMTP2GO username | SMTP2GO password |
| Brevo | smtp-relay.brevo.com | account email | Brevo SMTP key |
| SparkPost | smtp.sparkpostmail.com | SMTP_Injection | SparkPost API key |
| Elastic Email | smtp.elasticemail.com | account email | Elastic Email API key |
| Mailtrap | live.smtp.mailtrap.io | api | Mailtrap sending token |
| Mailjet | in-v3.mailjet.com | Mailjet API key | Mailjet secret key |
| SMTP.com | send.smtp.com | account username | SMTP.com password |
Step 4: Send a Test Email
Step 5: Point the Webhooks
https://yourdomain.com/webhook.php/{provider}?key=YOURWEBHOOKKEY, with {provider} being the lowercase name, like sendgrid or mailgun. For Amazon SES, subscribe that URL to your SNS topic and the engine confirms the subscription automatically.The webhooks are how delivered, bounces, opens, clicks, complaints, and unsubscribes flow back into your contact profiles, and how hard bounces and complaints get suppressed automatically. Without them the engine sends fine but learns nothing. The exact event lists per provider are in the documentation, and what the engine does with each event is covered in bounces, complaints, and unsubscribes.
Email Campaign Engine is free and open source, and works with every provider above over plain SMTP.
Get the Code on GitHubPrefer it managed? Contact our team about the hosted Email Broadcast app.