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

# Mailgun

> Configure Mailgun as your email provider in Notifuse.

Mailgun integration allows you to use Mailgun for sending transactional emails through Notifuse.

<img className="block" src="https://mintcdn.com/notifuse/Gw4P7NadUImyvZfw/assets/screenshots/mailgun_form.png?fit=max&auto=format&n=Gw4P7NadUImyvZfw&q=85&s=fa2cc24fcb5ef1aa4f7071197f317862" alt="Mailgun Integration Form" width="3217" height="1933" data-path="assets/screenshots/mailgun_form.png" />

## Configuration

Navigate to **Settings** → **Integrations** → **Add Integration** → **Mailgun**.

<img className="block" src="https://mintcdn.com/notifuse/Gw4P7NadUImyvZfw/assets/screenshots/mailgun_settings.png?fit=max&auto=format&n=Gw4P7NadUImyvZfw&q=85&s=2a3459e46886cd44833d69298482859d" alt="Mailgun Settings" width="2348" height="814" data-path="assets/screenshots/mailgun_settings.png" />

### Form Fields

| Field       | Description                  | Example                   |
| ----------- | ---------------------------- | ------------------------- |
| **Domain**  | Your verified sending domain | `mg.yourdomain.com`       |
| **API Key** | Your Mailgun private API key | `key-1234567890abcdef...` |
| **Region**  | Mailgun region dropdown      | `US` or `EU`              |

### Senders List

Add sender addresses that have been verified in your Mailgun account:

| Field     | Description                 | Example                  |
| --------- | --------------------------- | ------------------------ |
| **Name**  | Display name for the sender | `Support Team`           |
| **Email** | Sender email address        | `support@yourdomain.com` |

**Important**: Senders must be verified in Mailgun console before they can be used.

### Usage Types

Mailgun can be used for both transactional emails and broadcast campaigns:

| Option                    | Description                                       | Examples                                                    |
| ------------------------- | ------------------------------------------------- | ----------------------------------------------------------- |
| **Use for Transactional** | System-generated emails triggered by user actions | Password resets, order confirmations, account notifications |
| **Use for Broadcasts**    | Mass email campaigns and newsletters              | Marketing newsletters, product updates, promotional emails  |

### Webhooks

Notifuse automatically registers the following Mailgun webhooks:

| Webhook Type   | Description                     | Purpose                     |
| -------------- | ------------------------------- | --------------------------- |
| **Delivery**   | Email successfully delivered    | Track successful deliveries |
| **Bounce**     | Email bounced                   | Monitor bounces             |
| **Complaints** | Recipient filed abuse complaint | Handle abuse reports        |

These webhooks provide real-time feedback on email performance and delivery status.

## Prerequisites

Before configuring Mailgun:

1. **Mailgun Account**: Active Mailgun account
2. **Verified Domain**: Domain verified in Mailgun console
3. **API Key**: Mailgun private API key

## Testing

Click **Test Integration** to verify your configuration.