Connect Mailgun

Overview

Mailgun organizes sending around domains. Every send is associated with a Mailgun domain, and the domain determines which DNS records Mailgun expects. Mailgun has two regional infrastructures: US (default) and EU. The EU region keeps data within Europe — use it if your recipients or your own data residency requirements demand it.

Get your credentials

1. Log in to app.mailgun.com
2. Go to Sending → Domains and confirm your sending domain is verified (or add a new one and follow the DNS instructions)
3. Go to Settings → API Keys
4. Create a new Sending API Key (not the Private API Key — that has broader permissions than you need)
5. Note which region your domain lives in (visible on the domain list page)

Add the provider in Nudgel

1. Go to Settings → Providers
2. Click Add a provider
3. Pick Mailgun
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 — Mailgun",
    "bodyHtml": "<p>If you can read this, Mailgun is wired up.</p>",
    "bodyText": "If you can read this, Mailgun is wired up."
  }'

Check Mailgun → Logs (under your domain) to confirm the message was accepted.

Set up webhooks

Configure webhooks in Mailgun → Sending → Webhooks. You can set different URLs per event type, but the simplest setup is one URL for all events.

Set the URL to:

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

Enable: Delivered, Permanent failure (hard bounce), Complained (spam), Unsubscribed. Hard bounces and spam complaints auto-add to your suppression list. See the webhooks guide.

Verify your sending domain at Mailgun

To send from your own domain (e.g. mail.example.co.ke) through Mailgun, publish DKIM records Mailgun 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 Mailgun. Nudgel calls Mailgun'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.

Mailgun-specific notes

• US and EU regions are independent — always verify the domain in the region matching your Nudgel provider config. A domain verified in EU is not visible from the US API.
• Mailgun returns three record types for a verified domain: a DKIM TXT, an SPF TXT, and a tracking CNAME. Publish all three.

Full setup walkthrough: Sending domains setup

Troubleshooting