# Mailgun integration

{% hint style="info" %}
If you’re new to integrations in Rewst, read through our introductory integration documentation [here](https://docs.rewst.help/documentation/integrations).
{% endhint %}

## What does the Mailgun integration do?

Our Mailgun integration enables the automation of email communications. Use the Mailgun API within Rewst workflows to send emails, trigger workflows when receiving emails, and more.

## Set up the Mailgun integration

### Set up steps in Mailgun

1. Log in to Mailgun.
2. Navigate to **Sending > Domain Settings > Sending Keys**.
3. Choose your appropriate domain from the drop-down selector, if you use multiple domains.
4. Click **Add sending key**.
5. Enter a name for the key.
6. Copy the **Sending API key** value displayed in the dialog.  You won't be able to view the key again after you close it. Store this key somewhere secure. You'll need it for further steps in Rewst.

### Set up steps in Rewst

1. Navigate to **Marketplace > Integrations** in the left side menu of your Rewst platform.
2. Search for `Mailgun` in the integrations page.\
   \
   ![](https://1835401289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQQ1EHVcEsGKBPVHmiav%2Fuploads%2F6hyvpKTWBYbJTsomrL8I%2FScreenshot%202025-05-02%20at%204.20.17%E2%80%AFPM.png?alt=media\&token=0eb529f1-4dcc-49ac-910b-0678a79cfb82)
3. Click on the integration tile to launch the configuration setup page.
4. Under **Parameters**, enter the information copied from Mailgun into the relevant fields:
   1. **Sending Domain**
   2. **API Key**
   3. **API URL**
5. Click **Save Configuration**.

{% hint style="info" %}
The Mailgun integration does not require you to complete the organization mapping process.
{% endhint %}

{% hint style="success" %}
Got an idea for a new Integration? Rewst is constantly adding new integrations to our integrations page. Submit your idea or upvote existing ideas here in our [Canny feedback collector](https://rewst.canny.io/integrations).
{% endhint %}

## Triggers for Mailgun integration

| Trigger type name         | Type    | Description                                 |
| ------------------------- | ------- | ------------------------------------------- |
| mailgun\_event\_generated | Polling | Trigger which indicates a new mailgun event |

## Actions and endpoints

{% hint style="info" %}
For more on how actions work in Rewst, check out our [introductory actions documentation here](https://docs.rewst.help/documentation/workflows/actions-in-rewst). 
{% endhint %}

| Category            | Action              | Description                                                              |
| ------------------- | ------------------- | ------------------------------------------------------------------------ |
| **Generic Request** | Mailgun API Request | Generic action for making authenticated requests against the Mailgun API |
| **Send Email**      | Send Email          | Send email via Mailgun HTTP API.                                         |
| **Test Action**     | Send Email          | Send email via Mailgun HTTP API.                                         |


---

# 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.rewst.help/documentation/integrations/integration-guides/mailgun-integration-setup.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.