ToolJet/docs/versioned_docs/version-3.0.0-LTS/data-sources/mailgun.md
Pratik Agrawal ca809960db
[docs]: Remove breaking relative links (#11326)
* docs: remove relative links

* removed all the relative links

* remove relative links

* docs: add new tags to CYT

---------

Co-authored-by: Aman Regu <amanregu@gmail.com>
2024-11-14 14:22:03 +05:30

63 lines
1.9 KiB
Markdown

---
id: mailgun
title: Mailgun
---
ToolJet can connect to your Mailgun account to send emails.
:::info
The Mailgun API Datasource supports for interaction with the mail endpoint of the [Mailgun API](https://documentation.mailgun.com/en/latest/api-intro.html#authentication-1).
:::
<div style={{paddingTop:'24px'}}>
## Connection
To establish a connection with the **Mailgun** data source, click on the **+ Add new data source** button located on the query panel or navigate to the [Data Sources](/docs/data-sources/overview) page from the ToolJet dashboard.
ToolJet requires the following to connect to your Mailgun:
- **API key**
<img class="screenshot-full" src="/img/datasource-reference/mailgun/mailgun-datasource-v3.png" alt="ToolJet - Data source - Mailgun" />
:::tip
Mailgun API key is required to create an Mailgun datasource on ToolJet. You can generate API key by visiting [Mailgun account page](https://app.mailgun.com/app/account/security/api_keys).
:::
</div>
<div style={{paddingTop:'24px'}}>
## Supported Operations
### Email Service
#### Required parameters:
- **Send email to**
- **Send email from**
- **Subject**
- **Body as text**
#### Optional parameters:
- **Body as HTML**
<img class="screenshot-full" src="/img/datasource-reference/mailgun/mailgunQuery.png" alt="ToolJet - Data source - Mailgun Query" />
:::info
**Send mail to** - accepts a single email id.
For example:
`{{"dev@tooljet.io"}}`.
**Send mail from** - accepts a string.
For example: `admin@tooljet.io`
:::
:::tip
**Send a single email to multiple recipients** - The `Send mail to` field can contain an array of recipients, which will send a single email with all of the recipients in the field.
**Send multiple individual emails to multiple recipients** - set <b>Multiple recipients</b> field to `{{true}}` and the `Send mail to` field will be split into multiple emails and send to each recipient.
:::
</div>