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

# Mailgun

> How to integrate Mailgun with Admina using an API key. Admina retrieves data such as user names, email addresses, and roles.

## Integration Specifications

<dl />

## Prerequisites

### Getting your API key

1. After logging in to Mailgun, click your profile in the top right corner and select **API Security**.

   ![Mailgun profile menu with API Security under ACCOUNT SETTINGS highlighted](https://mintcdn.com/moneyforwardi/i60DKphgZqm4UCWa/images/integrations/mailgun/api-security-menu.png?fit=max\&auto=format\&n=i60DKphgZqm4UCWa\&q=85\&s=a58d8db96f0f16e1f40a4df51fe3d9f2)

2. Click **Create API Key**. On the screen that appears, enter a name for the integration in **Description**. Then click **Create Key**.

   ![Mailgun Create API key screen with the Description field and the Create Key button highlighted](https://mintcdn.com/moneyforwardi/i60DKphgZqm4UCWa/images/integrations/mailgun/create-api-key.png?fit=max\&auto=format\&n=i60DKphgZqm4UCWa\&q=85\&s=c475080948bb2486df02a3d5acbfb85a)

3. Click **Copy to clipboard** above the **API key** to copy it, and store it in a safe place. The API key is displayed only once. After you copy it, click **Done**.

   ![Mailgun screen showing the API key, with the Copy to clipboard button and the Done button highlighted](https://mintcdn.com/moneyforwardi/i60DKphgZqm4UCWa/images/integrations/mailgun/copy-api-key.png?fit=max\&auto=format\&n=i60DKphgZqm4UCWa\&q=85\&s=ec4a871d05e43621d1d5815e47934c15)

## Setting up the integration

1. On the integration screen, search for **Mailgun**.

2. Enter the API key you saved in the previous step into **API key**, and click **Connect**. **Workspace name** is optional.

   ![Mailgun integration setup screen showing the Workspace name and API key fields](https://mintcdn.com/moneyforwardi/i60DKphgZqm4UCWa/images/integrations/mailgun/integrate-workspace.png?fit=max\&auto=format\&n=i60DKphgZqm4UCWa\&q=85\&s=3db7aa8c2009b04d1810afefb79b0411)

3. Once the integration with Mailgun succeeds, registered user information appears in the account list. If it doesn't complete successfully, first try the steps in [Troubleshoot SaaS integration errors](https://support.i.moneyforward.com/en/it-management/saas-management/93nahw45is-trouble.md). If that doesn't resolve it, check [Information to provide](https://support.i.moneyforward.com/en/it-management/saas-management/93nahw45is-trouble.md#info-to-provide) and contact [support](https://support.i.moneyforward.com/en/contact-support.md).


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