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

# Mailgun

## Overview

> [card] [Pre-built tooling](#pre-built-tooling)

> [card] [Pre-built integrations](#pre-built-integrations)

> [card] [Access requirements](#access-requirements)

> [card] [Setup guide](#setup-guide)

> [card] [Useful links](#useful-links)

> [card] [API gotchas](#api-gotchas)

## Pre-built tooling

> [accordion] ✅ Authorization
>
> | Tools | Status |
> | - | - |
> | Pre-built authorization (Basic) | ✅ |
> | Pre-built authorization UI | ✅ |
> | Custom authorization UI | ✅ |
> | End-user authorization guide | ✅ |
> | Expired credentials detection | ✅ |

> [accordion] ✅ Read & write data
>
> | Tools | Status |
> | - | - |
> | Pre-built integrations | ✅ |
> | API unification | ✅ |
> | 2-way sync | ✅ |
> | Webhooks from Nango on data modifications | ✅ |
> | Real-time webhooks from 3rd-party API | 🚫 (time to contribute: \<48h) |
> | Proxy requests | ✅ |

> [accordion] ✅ Observability & data quality
>
> | Tools | Status |
> | - | - |
> | HTTP request logging | ✅ |
> | End-to-end type safety | ✅ |
> | Data runtime validation | ✅ |
> | OpenTelemetry export | ✅ |
> | Slack alerts on errors | ✅ |
> | Integration status API | ✅ |

> [accordion] ✅ Customization
>
> | Tools | Status |
> | - | - |
> | Create or customize use-cases | ✅ |
> | Pre-configured pagination | 🚫 (time to contribute: \<48h) |
> | Pre-configured rate-limit handling | 🚫 (time to contribute: \<48h) |
> | Per-customer configurations | ✅ |

### Others

| Function name | Description | Type |
| - | - | - |
| `add-list-member` | Add a member (subscriber) to a Mailgun mailing list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-bounce` | Manually add an address to a domain's bounce suppression list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-complaint` | Manually add an address to a domain's spam-complaint suppression list | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-list` | Create a new mailing list | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-template` | Create a new message template (with its initial version). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-unsubscribe` | Manually add an address to a domain's unsubscribe suppression list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-whitelist-entry` | Add an address or domain to a domain's sending allowlist, bypassing spam filtering for it. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-bounce` | Remove an address from a domain's bounce suppression list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-complaint` | Remove an address from a domain's spam-complaint suppression list | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-list` | Delete a mailing list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-template` | Delete a template and all its versions. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-unsubscribe` | Remove an address from a domain unsubscribe suppression list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-whitelist-entry` | Remove an address or domain from the sending allowlist of a Mailgun domain. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-bounce` | Check whether a specific address is on a domain bounce suppression list | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-complaint` | Check whether a specific address is on a domain's spam-complaint suppression list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-domain` | Retrieve a single sending domain's details, including DNS records. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-list-member` | Retrieve a single mailing list member by email. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-list-with-members` | Retrieves a mailing list's details together with its full member roster in one call. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-list` | Retrieve a single mailing list by its address | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-template` | Retrieve a single template's details by name | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-unsubscribe` | Check whether a specific address is on a domain's unsubscribe suppression list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-whitelist-entry` | Retrieve a single allowlist (whitelist) entry by address. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-bounces` | List hard-bounce suppression entries for a domain. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-complaints` | List spam-complaint suppression entries for a domain. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-domains` | List sending domains on the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-events` | List delivery/open/click/bounce/complaint event log entries for a domain | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-list-members` | List members of a mailing list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-lists` | List mailing lists on the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-templates` | List stored message templates for a domain | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-unsubscribes` | List unsubscribe suppression entries for a Mailgun domain. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-whitelist-entries` | List a domain's sending allowlist (whitelist) entries | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `remove-list-member` | Remove a member from a mailing list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `send-email-safely` | Checks a recipient against the domain's bounce, complaint, and unsubscribe suppression lists and only sends the message if the address is not suppressed. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `send-message` | Send an email message through a domain. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `subscribe-email-to-list` | Add a member to a mailing list, automatically creating the list first if it does not exist yet. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-list-member` | Update a mailing list member's subscription status, name, or custom variables. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-template` | Update a template's metadata (description and/or name). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `bounces` | Sync hard-bounce suppression entries, fanned out across all domains on the Mailgun account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `complaints` | Sync spam-complaint suppression entries, fanned out across all Mailgun domains on the connection | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `domains` | Sync all sending domains on the Mailgun account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `events` | Syncs Mailgun event log entries (accepted, delivered, failed, rejected, opened, clicked, complained, etc.) across all domains on the connection. Incremental via a per-domain timestamp high-watermark; only covers the Mailgun event retention window, not a permanent archive. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `list-members` | Sync members across all Mailgun mailing lists: enumerate every mailing list, then fetch every member of each list tagged with its parent list address | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `lists` | Sync mailing lists on the account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `templates` | Syncs stored message templates, fanned out across all Mailgun domains on the account | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `unsubscribes` | Sync domain-wide unsubscribe suppression entries, fanned out across all Mailgun domains | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |

## Access requirements

| Pre-Requisites | Status | Comment |
| - | - | - |
| Paid dev account | ❓ | |
| Paid test account | ❓ | |
| Partnership | ❓ | |
| App review | ❓ | |
| Security audit | ❓ | |

## Setup guide

*No setup guide yet.*

> [!TIP]
>
> Need help getting started? Get help in the [community](https://nango.dev/slack).

> [!NOTE]
>
> Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/mailgun.mdx)

## Useful links

* [Mailgun API docs](https://documentation.mailgun.com/docs/mailgun/api-reference/authentication/)

> [!NOTE]
>
> Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/mailgun.mdx)

## API gotchas

When adding a new connection, api is the region for US-based customers, and api.eu is the region for EU-based customers.

> [!NOTE]
>
> Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/mailgun.mdx)

## Going further

> [card] [Connect to Mailgun](https://nango.dev/docs/integrations/all/mailgun/connect)
>
> Guide to connect to Mailgun using Nango Connect.


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