> ## Documentation Index
> Fetch the complete documentation index at: https://docs.streamly.watch/llms.txt
> Use this file to discover all available pages before exploring further.

# Mailgun Plugin

> Mailgun transactional email — API key, domain, region, from address, webhook.

**Mailgun** (`email.mailgun`) is a Streamly **plugin** in the **email** category.

Alternate transactional provider. Prefer [Resend](/plugins/resend) unless you already run Mailgun.

## Learn the service

Watch this overview of the vendor platform (helpful before you paste keys into Streamly).

<Frame caption="Getting Started with Mailgun — Sinch Mailgun.">
  <iframe src="https://www.youtube.com/embed/BmEj3EBo0vg" title="Getting Started with Mailgun" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen />
</Frame>

## At a glance

| | |
| - | - |
| **Plugin ID** | `email.mailgun` |
| **Webhook** | `POST /api/webhooks/mailgun` |

## How it works

Configure domain + API key (+ region). Default from: `Streamly <noreply@{domain}>` when `fromEmail` omitted.

<Note>
  Webhook endpoint: `POST /api/webhooks/mailgun`
</Note>

## Activation keys

Configure in `/admin/plugins` → **Mailgun** → Configure. Secret fields stay server-side — never commit them or expose as `NEXT_PUBLIC_*` unless the key is intentionally public (e.g. Stripe publishable key).

| Key | Label | Required | Secret | Docs |
| - | - | - | - | - |
| `apiKey` | API key | Yes | Yes | [Get started](https://documentation.mailgun.com/docs/mailgun/user-manual/get-started/) |
| `domain` | Sending domain | Yes | No | [Domains](https://documentation.mailgun.com/docs/mailgun/user-manual/domains/) |
| `fromEmail` | From email | Optional | No | [Send](https://documentation.mailgun.com/docs/mailgun/user-manual/send-email/) |
| `region` | `us` or `eu` | Optional | No | [Base URL](https://documentation.mailgun.com/docs/mailgun/api-reference/api-intro/#base-url) |

## Setup guide

<Steps>
  <Step title="Verify domain">Mailgun DNS.</Step>
  <Step title="Configure plugin">apiKey + domain (+ region/from).</Step>
  <Step title="Test send">Trigger any system email.</Step>
</Steps>

## Official vendor documentation

* [Get started](https://documentation.mailgun.com/docs/mailgun/user-manual/get-started/)
* [Domains](https://documentation.mailgun.com/docs/mailgun/user-manual/domains/)
* [Send email](https://documentation.mailgun.com/docs/mailgun/user-manual/send-email/)

## Related

* [Resend](/plugins/resend)
* [Plugins Overview](/plugins/overview)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.