# Mailgun

{% embed url="<https://www.loom.com/share/650fd6c9a0634fd18f149ef9da828bec>" %}
Mailgun connection tutorial
{% endembed %}

> **Boomerangme > Left-Hand Menu > Settings > White Label**

1. Follow the workflow mentioned above to land on the White Label screen.<br>
2. From the buttons displayed at the top-right corner, click Other Settings.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FG0fbmACVb7H6FQIDNJcs%2Fimage.png?alt=media&#x26;token=1afbc99e-f2a2-4a3a-8599-baffbdca2ad9" alt=""><figcaption><p>Other Settings</p></figcaption></figure>

3. Navigate to the Mailgun Tile and click the Connect Account button.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FSFMOlVBPq8cvgd6Rlxdv%2Fimage.png?alt=media&#x26;token=2b5622bb-e585-4de1-8776-b91d8a109921" alt=""><figcaption><p>Connect Account</p></figcaption></figure>

4. Doing so opens the Connecting a Mailgun account popup. Here, enter your Mailgun API key in the API Key field.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2F3bJeekQHmVJcfcz4NYBr%2Fimage.png?alt=media&#x26;token=57817177-3360-4bc9-b04a-a54151ca44c5" alt=""><figcaption></figcaption></figure>

### Support for Multiple Mailgun Mailboxes: <a href="#support-for-multiple-mailgun-mailboxes" id="support-for-multiple-mailgun-mailboxes"></a>

It is now possible to connect both a primary mailbox for general mailings (e.g., registration details, password resets, etc.) and additional mailboxes used exclusively for mailings via Richie.

First, select the primary mailbox from the list of available mailboxes and enter the sender name. This mailbox will be used to send:

* welcome emails after your clients (sub-accounts) register
* password recovery emails
* manager registration emails

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FWSbJPg7MPwXBtkqiNOqy%2Fimage.png?alt=media&#x26;token=0634726f-f730-488e-855f-03fed1fca97f" alt=""><figcaption></figcaption></figure>

❗️ If you encounter an error where the address list is not visible after adding the API key and the Connect button remains inactive. , please check the following:

1. Go to **Domain Settings**
2. Click on **SMTP Credentials**
3. Click the **\[Add new SMTP user]** button
4. Add several SMTP users

Then, try connecting Boomerang again.

After selecting the primary mailbox, the user needs to enter the sender name and choose additional mailboxes for mailings via Richie. You can select as many mailboxes as you have configured in your Mailgun account.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FPlo9EtyHRiwUcNvTCUKU%2Fimage.png?alt=media&#x26;token=edb74657-bf46-4c2e-86f2-9236e340366b" alt=""><figcaption></figcaption></figure>

After selecting the mailboxes, click "Connect". Connect and you're all set!\
You're now ready to receive and manage emails seamlessly with Mailgun and Boomerangme

### Setting up an email sender at the agency level for sub-accounts

{% embed url="<https://youtu.be/ILvx4OYYnE8?si=YPmkoPD06umb2Gp1>" %}

We’ve enabled centralized e-mail sending: the agency connects its own Mailgun at the agency level and selects a sender address. Sub-accounts can then send e-mails billed to the agency, without configuring their own Mailgun. Campaigns are available immediately after a sub-account is created.

Each sub-account has a monthly limit of 100,000 messages. Once the limit is reached, sending is paused until the next billing period (or until the limit is increased).

Sub-accounts can still connect their own Mailgun if needed — this option remains unchanged.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FpjzzgunEGL6cEA5XTGaE%2Fimage.png?alt=media&#x26;token=ace85644-d17b-4c47-b165-87b42df1a3ef" alt="Setting up an email sender at the agency level for sub-accounts"><figcaption></figcaption></figure>

**The sender name is generated dynamically for each sub-account.**\
A sub-account–specific variable is automatically appended to the base name, so the displayed sender name is unique for each sub-account.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2Fnca6u8MY9rd5VwjQ2ir0%2Fimage.png?alt=media&#x26;token=e1ad6d18-fcc4-470f-9551-2be49d8baf5c" alt="The sender name is generated dynamically for each sub-account."><figcaption></figcaption></figure>

### Edit mailgun connection <a href="#edit-mailgun-connection" id="edit-mailgun-connection"></a>

At any time, you can edit the connection, select new mailboxes, or disconnect old ones. To do this, use the "Edit" button.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FohI48MBmbxjKmqfbnOAD%2Fimage.png?alt=media&#x26;token=7998770f-d53a-4105-8ede-169c9c60c39f" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.boomerangme.cards/white-label/mailgun.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
