Connect Brevo

Overview

Brevo is GDPR-friendly (EU-based infrastructure), has a generous free tier (300 emails/day), and a clean API. It is a strong choice for teams based in Europe or those sending to European recipients where data residency matters. Authentication is a single API key.

Get your credentials

1. Log in to app.brevo.com
2. Click your name in the top right → SMTP & API
3. Go to the API Keys tab
4. Click Generate a new API key, give it a name, and copy the key
5. Verify your from address or domain: Settings → Senders & IP → Domains

Add the provider in Nudgel

1. Go to Settings → Providers
2. Click Add a provider
3. Pick Brevo
4. Fill in the fields:

Test the connection

curl -X POST https://api-raven-cloud.autotribes.app/v1/messages \
  -H "X-Raven-Key: rk_live_a3f7b2c1_..." \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "to": "you@example.com",
    "from": "noreply@mail.acme.co.ke",
    "subject": "Nudgel test — Brevo",
    "bodyHtml": "<p>If you can read this, Brevo is wired up.</p>",
    "bodyText": "If you can read this, Brevo is wired up."
  }'

Confirm in Brevo → Transactional → Email → Log — the message should appear within seconds.

Set up webhooks

Brevo calls these Transactional webhooks. Configure them under Transactional → Settings → Webhook.

Set the URL to:

https://api-raven-cloud.autotribes.app/v1/webhooks/email/brevo/{YOUR_TENANT_ID}

Enable: Delivered, Hard bounce, Spam, Unsubscribed. Hard bounces and spam reports auto-add to your suppression list. See the webhooks guide.

Verify your sending domain at Brevo

To send from your own domain (e.g. mail.example.co.ke) through Brevo, publish DKIM records Brevo generates for you. Nudgel orchestrates this from one dashboard.

1. In Nudgel dashboard, go to Settings → Sending domains → Add domain, enter your domain.
2. On the next screen, select Brevo. Nudgel calls Brevo's domain registration API using your credentials and shows you the DNS records to publish.
3. Publish the records at your DNS host (Cloudflare, Route 53, etc.).
4. Nudgel polls every 30 seconds for the first 10 minutes, then hourly. Verification surfaces in the dashboard automatically.

Brevo-specific notes

• Brevo requires a domain ownership TXT record (brevo-code=...) in addition to the DKIM TXT. Both must be published before Brevo considers the domain verified.
• Nudgel surfaces all required records together — publish all of them, not just the DKIM.

Full setup walkthrough: Sending domains setup

Troubleshooting