Help

Setting up Brevo.

Add your domain in Brevo, paste one API key into Newsletter Sender, and you are ready to send. Setup takes about 10 minutes, most of which is simply waiting for DNS records to propagate.

All help

1Before you start

  • A Brevo account: sign up at brevo.com if you haven't already.
  • Your sender address: check your From address (such as news@yourdomain.com) in Newsletter Sender under Settings → Your company. Brevo must be set up for this address's domain.
Amazon SES or Brevo? Amazon SES offers much lower pricing for large subscriber lists, but takes a few more steps to set up. Brevo is much simpler to set up. You can swap providers at any time under Settings → Sending without losing your subscribers or drafts. See Set up Amazon SES.

2Add and verify your domain in Brevo

  1. In Brevo, open Senders, Domains & Dedicated IPs, then Domains and click Add a domain. Use the domain your newsletters come from.
  2. Brevo shows the records to add: a Brevo code TXT record, DKIM and DMARC. Add them where your domain's DNS is (see the tips below).
  3. Click Authenticate this email domain.
  • If your DNS is on Cloudflare: go to DNS → Records → Add record. Set any CNAME records to DNS only (grey cloud), not Proxied (orange cloud), or Brevo can't verify them.
  • If your DNS is elsewhere: copy each name and value into your DNS host's dashboard (such as GoDaddy or Namecheap).

DNS records typically take effect within a few minutes, though some hosts take up to a few hours.

3Make an API key

  1. Open your name at the top right, then SMTP & API and the API Keys tab.
  2. Click Generate a new API key, name it Newsletter Sender and copy it. Brevo only shows it once.

Open Brevo API keys

4Connect Brevo to Newsletter Sender

  1. In Newsletter Sender, go to Settings → Sending and select Brevo.
  2. Paste the key into API key.
  3. (Optional) Sending rate: enter your account's limit under Emails per second. Leave it blank to use the default of 10 a second.
  4. Click Save.

Newsletter Sender checks the API key with Brevo and sends a test email to your own address. Once it works, your API key is encrypted inside your own Cloudflare account and hidden from view.

Newsletter Sender's Sending settings with Brevo chosen and the key box
Example details shown.

5Automatic bounce and complaint tracking

When you click Save, Newsletter Sender uses your API key to add its webhook for you.

This means every hard bounce and spam complaint comes straight back to Newsletter Sender, and those contacts are never emailed again. Once it's active, Settings → Sending shows a green tick.

If the webhook couldn't be added automatically

The page shows an Add it for me button to try again, alongside the webhook address to add yourself:

  1. In Brevo, open Transactional → Settings → Webhooks and add a webhook with the address. Tick Hard bounce, Soft bounce, Invalid email and Complaint.
Back: set up MailgunNext: set up Resend