Integrate Mailgun with Apollo

Article author
Sarah Malone
Updated

Overview

 
It Depends on Your Plan

Please note, if you created your Mailgun account with a domain from an EU server, unfortunately, you cannot currently integrate your Mailgun account with Apollo.

Access to the Mailgun integration also depends on your Apollo plan. For more information, check out the pricing comparison chart. To upgrade your plan, head to the manage plan settings in Apollo or reach out to the Apollo Sales Team for further guidance.

If you already actively use Mailgun for transactional or marketing emails, you can integrate your account with Apollo to send higher volumes of emails.

(Remember) Before you set up the Mailgun integration, you need to:

 
Toe the Mailgun Line!

Please note, you and your team must comply with Mailgun's user consent policy and follow email best practices to use Mailgun's server responsibly. If you email contacts without their consent, Mailgun may block your domain.

Refer to the following sections for the steps to integrate your Mailgun account with Apollo.

Back To Top

Connect Your Mailgun Account to Apollo

To integrate your Mailgun account with Apollo:

  1. Launch Apollo, click Settings, and then click the Integrations icon.
  2. Scroll to Mailgun and then click Connect. Connect Mailgun Button on Integration Page
  3. Fill in your Mailgun primary account API key and click Link API key. Link Mailgun Button
 
Getting the Goods!

Please keep in mind that the primary account API key must be a private key. If you're not sure where to find your key, fear not! Mailgun has got you covered! Check out the Where Can I Find My API Key and SMTP Credentials? article on the Mailgun Knowledge Base. Please also note that Apollo does not support Mailgun domain sending keys. For more information about the different API keys in Mailgun, read this section of the Mailgun API Reference Guide.

You have now connected your Mailgun account to Apollo.

Mailgun Integrated

(Reminder) Apollo does not support IP whitelisting in Mailgun. If you enable IP whitelisting, you cannot deliver Mailgun messages through Apollo. For more information on IP whitelisting, please read the IP Reputation/Management section of the Mailgun Knowledge Base.

Back to Top

Add Mailgun Webhooks for Your Domains

 
You Snooze, You Lose!

This is an important step, folks! To ensure full functionality of the Mailgun integration, add a webhook for each domain you use to send emails from in Apollo. But don't worry—it's not as scary as it sounds. Follow the simple steps below, and voila! Like magic, you can start tracking the performance of your sequences and identify bounced emails with accuracy to improve your email deliverability rates.

Now that you have connected Mailgun, Apollo displays all the domains connected to your Mailgun account.

Mailgun domains

To add Mailgun webhooks for your domains:

  1. Click Add tracking next to each of the domains that you want to connect. Add webhook button
  2. You have now added a Mailgun webhook to Apollo. Success modal on Mailgun integrations page

To delete a connected webhook from Apollo:

  1. Click Remove tracking. Delete webhook
     
    Making Lemonade Outta Lemons!

    Please note, Apollo only automatically pulls in the list of domains from Mailgun when you first integrate Mailgun with Apollo. This means that if you add or delete a domain in Mailgun, the change does not immediately reflect in the list of domains in Apollo. However, no need to panic! If you make any changes in Mailgun, you can click Refresh List. Apollo then refreshes the list as well as the status of the Mailgun webhook in Apollo. Refresh List button

  2. If you try to add or remove a webhook from a domain that no longer exists in Mailgun, Apollo displays an error message. Error message
     
    Whoops!

    Deleted the wrong domain? You'll need to reconnect the domain in Mailgun before you can add the Mailgun webhook in Apollo. For more information about how to add and delete domains in Mailgun, hop into this article in the Mailgun Knowledge Base.

  3. You can only connect 1 webhook per domain with the Apollo<>Mailgun Integration. If you encounter the following error, you can delete a non-Apollo webhook from Mailgun or manually add the webhook in Mailgun. Error message 2 </>

For more information about how to add or delete webhooks in Mailgun, please refer to the Guide to Using Mailgun Webhooks in the Mailgun Knowledge Base. Alternatively, you can use another domain instead.

Back to Top

Enable Mailgun for a Mailbox

To enable Mailgun for a mailbox:

  1. Click Settings. Then, click the Mailboxes tab in your Personal Profile. Personal Profiles Settings
  2. Click the Additional Options (...) button to select the mailbox that you would like to enable with Mailgun. Then, click Send emails from Mailgun. Send Emails from Mailgun Button

You have now enabled Mailgun for a mailbox in Apollo.

 
You Call the Shots

Please note, you can stop sending emails from Mailgun at any time. To do so, click the Additional Options (...) button again and then click Stop sending emails from Mailgun.

Stop Sending Emails from Mailgun Button

Back to Top

Confirm You're Set Up

To confirm that you've integrated Mailgun correctly:

  1. Launch Apollo, click Settings, and then click the Mailboxes tab.
  2. You will see Send From Mailgun below the default email address. This confirms that you have set up Mailgun correctly in Apollo. Send From Mailgun Text Below Default Email
 
Emails Not Showing in Apollo?

Do you follow best practices and use tracking subdomains to protect your domain reputation? Do you also forward the emails that you send from Mailgun via a secondary domain onto your primary domain? If so, make sure you link both mailboxes with Apollo. If you don't connect your primary domain with Apollo but do forward the emails you send via Mailgun to it, please note that those emails will not appear in Apollo. For help linking more mailboxes, refer to this article.

Back to Top

Edit Your Daily and Hourly Send Rates

To adjust your daily and hourly send rates for a connected mailbox in Apollo:

  1. Click Settings. Then, click manage sending limits under each linked Mailbox. Manage Sending Limits
  2. Click the mailbox for which you want to adjust the sending limits. Mailbox
  3. From here, you can adjust the Emails sent per day and the Emails Sent Per Hour fields. Email Sending Limits
 
Your Reputation Matters

Please note, although you can send more emails per day and hour with Mailgun, you must still be mindful of email best practices and comply with Mailgun's acceptable use policy to avoid issues.

You have now edited your email sending limits in Apollo. For more information, refer to the Email Sending Limits Overview article.

Back to Top