--- title: "Mailgun channel" slug: "mailgun-channel" updated: 2026-04-27T19:24:52Z published: 2026-04-27T19:24:52Z --- > ## Documentation Index > Fetch the complete documentation index at: https://help.quickbase.com/llms.txt > Use this file to discover all available pages before exploring further. # Mailgun channel > *Go to the*[*Channels*](https://team.quickbase.com/nav/main/action/pipelines/channels)*page to learn more about what plans have access to this channel. Sign into Quickbase, and then go to Pipelines > Channels.* Mailgun is an email automation service provided by Rackspace, for developers. It offers a complete cloud-based email service for sending, receiving and tracking emails sent through your websites and applications. Terms used in the Mailgun channel categories are Mailgun specific terminology. ## How to create a Mailgun account You need to create a Mailgun account before you get started with your Mailgun channel. To create an account in Mailgun, navigate to [https://www.mailgun.com/](https://www.mailgun.com/) and select the large red **Start Sending** button. To create a free account, complete the following steps: 1. Enter your information. 2. Use your company email. 3. Enter a password. 4. Uncheck **Add payment info now**. 5. Check **I'm not a robot**. 6. Respond to verification email. The free account limits you to five authorized recipients. An email is sent to each address you add and the addresses will need to be verified. A paid version allow you to send up to 5000 emails. ## How to connect 1. On the My pipelines page, select **Create Pipeline**. 2. Search for or select a step, and then select it to add it to the pipeline. When you add a step to a pipeline, it is added to the canvas of the pipeline designer. 3. Expand the Connection section of the step, and add the required information. ### Connect to Mailgun 1. Expand **Mailgun** in the list of channels on the right side of the page and select **Connect to Mailgun**. ![Mailgun channel expanded in the channels list, showing the Connect to Mailgun button](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/4472990899604.png) 2. In the pop-up window, select your Account Type, API key, and the webhook key which you in **Settings** under the **API Keys** section in Mailgun 3. When finished, select **Connect to Mailgun. ![Mailgun connection pop-up with Account Type, API key, and webhook key fields](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/4472990947092.png)** ## How to reconnect You may need to reconnect your account to a channel. Reasons may be (but not limited to): - If you need to connect a different account. - Authorization updates, such as a changed password. - Editing the access rights that Pipelines has to the channel. To reconnect: 1. Select a pipeline that already has this channel in it. 2. Open a step that contains this channel. 3. Under account, select **Connect (or reconnect)** and follow the process above, [How to connect](/v1/docs/mailgun-channel#how-to-connect). ![Pipeline step connection panel showing the Connect (or reconnect) option](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/17568400830868.png) ## Steps The steps you can use with Mailgun are grouped into five categories: - Domains - Mailing List Members - Tags - Templates - Messages - Events - Mailing Lists **Note:** You cannot use jinja expressions in trigger conditions unless explicitly specified as possible. | Type | Name | Description | | --- | --- | --- | | Domains | | | | Query | Search a Domain | Searches and returns a list of domains based on search criteria. | | Action | Look Up a Domain | Looks for a particular domain based on specific criteria. To be able to use Mailgun in production, your custom domains has to be created and verified with Mailgun. | | Mailing List Members | | | | Action | Create Mailing List Member | Creates a member to a specific mailing list. | | Action | Update Mailing List Member | Updates the information for a mailing list member | | Action | Delete Mailing List Member | Deletes a mailing list member in your account. | | Query | Search a Mailing List Member | Searches for mailing list members and returns a list based on search criteria. | | Action | Lookup a Mailing List Member | Looks for a specific user using search criteria. | | Tags | | | | Action | Create a Tag | Creates a tag. | | Action | Update Tag | Updates a tag. | | Action | Delete Tag | Deletes a specific tag. | | Query | Search a Tag | Searches and returns a list based on search criteria. | | Action | Lookup a Tag | Looks for a particular tag based on search criteria. | | Templates | | | | Action | Create a Template | Creates a template in the specified account. Message templates allow you to create HTML templates on Mailgun's platform so that you can simply reference the template during your send. | | Action | Update Template | Updates the metadata information of a template specified in the url. | | Action | Delete Template | Deletes a template in the specified account. | | Query | Search a Template | Searches for a template based on search criteria and returns a list. | | Action | Lookup a Template | Looks up metadata information about a stored template specified in the url. | | Messages | | | | Trigger | On Inbound Email | Triggers when a new inbound email is received for the specified domain and account. | | Action | Send an Email | Sends an email from the specified account. You can send emails to individual email address, or to lists utilizing the list email. | | Events | | | | Trigger | On clicked | Triggers when an email is clicked in the specified Account and Domain. Click tracking must be enabled in the Mailgun control panel | | Trigger | On complained | Triggers when there is a SPAM complaint, when the email recipient has clicked on the spam complaint button. Feedback loops enable the notification to be received by Mailgun. | | Trigger | On delivered | Triggers when a new email is delivered. This means that Mailgun sent the email and it was accepted by the recipient email server. | | Trigger | On opened | Triggers when an email is opened. This means that the email recipient opened the email and enabled image viewing. Open tracking must be enabled in the Mailgun control panel. | | Trigger | On permanent fail | Triggers when there is a permanent failure delivering an email. This means that Mailgun could not deliver the email to the recipient email server, and Mailgun will stop attempting to deliver the message. | | Trigger | On temporary fail | Triggers when there is a temporary failure delivering an email. | | Trigger | On unsubscribed | Triggers when an *email unsubscribe* event happens. This means that the email recipient clicked on the unsubscribe link. Unsubscribe tracking must be enabled in the Mailgun control panel. | | Query | Search an Event | Searches events in a given account and domain and returns a list based on search criteria. | | Mailing Lists | | | | Action | Create Mailing List | Creates a new mailing list in the specified account. A mailing list is a group of members (recipients) which itself has an email address, like sc@mailgunservice.example.com. This address becomes an ID for this mailing list. | | Action | Update Mailing List | Updates an existing mailing list in the specified account. | | Action | Delete Mailing List | Deletes a mailing list in the specified account. | | Query | Search a Mailing List | Searches a mailing list and returns a list based on search criteria. | | Action | Lookup a Mailing List | Looks for a specific list matching the search criteria. | ## Examples using Mailgun Here are two case use examples of using Mailgun. ### Emailing from Quickbase You can use Mailgun to send out custom, personalized emails to individuals. These forms can be customized to include the necessary fields that are needed to be populated with in the pipeline. In this example, an email will be sent as a follow up to an activity posted to a customer's record. Here is an example of this pipeline. ![Example Quickbase pipeline for sending a follow-up email via Mailgun](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/4472983456916.png) ### Create Mailing List With Mailing Lists, you can create lists for your bulk emails. You an create these mailing lists within Quickbase and update them in Mailgun. For example, when a contact record is created, it can be associated to a specific campaign: ![Example Quickbase pipeline associating a new contact record to a Mailgun campaign](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/4473007295892.png) ![](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/4472975769236.png) Once you've created this mailing list, you can send bulk emails to all contacts on the list, by sending an email to the "Campaign Address." ![Mailgun Send an Email step configured with a campaign address for bulk email](https://cdn.document360.io/dd260e4e-10bb-4b66-8fb3-5504c272b904/Images/Documentation/4472991103764.png)