Mailgun

Use the Mailgun connector when your team already manages domain authentication, routes, logs, or deliverability operations in Mailgun.

Before you start

• Create a Mailgun API key with sending permissions.
• Verify the sending domain in the correct Mailgun region.
• Confirm whether your Mailgun account is US or EU, then choose the matching connector region.

Setup

flowchart LR
  MG[GenieOS] --> Region{Mailgun region}
  Region --> US[US API]
  Region --> EU[EU API]
  US --> Domain[Verified Mailgun domain]
  EU --> Domain
  Domain --> Recipient[Recipient]
  Domain --> Events[Mailgun events]
  Events --> MG

1. Open Settings -> Connectors and choose Mailgun.
2. Select the Mailgun region.
3. Paste the API key and sending domain.
4. Add the GenieOS webhook URL in Mailgun.
5. Send a connector test.

Capabilities

Webhooks and suppressions

Enable Mailgun webhooks for permanent failures, complaints, and unsubscribes at a minimum. Delivery, open, and click events are useful for complete timelines but may depend on Mailgun tracking settings.

Troubleshooting

• Region errors often look like authentication failures. Confirm the connector uses the same region as the Mailgun domain.
• from errors usually mean the sender domain does not match the configured Mailgun domain.
• Missing opens or clicks usually mean tracking is disabled for the domain.