Overview
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.
The Mailgun integration is also only available to users on a paid Apollo plan. If you are on a free plan or a free trial and want to upgrade, check out our pricing page or reach out to the Apollo Sales Team for more information.
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:
- Link your mailbox(es) to Apollo.
- Have an active Mailgun account. Head to the Getting Started section of the Mailgun Knowledge Base if you have Mailgun setup questions.
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.
Connect Your Mailgun Account to Apollo
To integrate your Mailgun account with Apollo:
- Launch Apollo, click Settings, and then click the Integrations icon.
- Scroll to Mailgun and then click Connect.
- Fill in your Mailgun primary account API key and click Link API key.
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.
(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.
Add Mailgun Webhooks for Your Domains
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.
To add Mailgun webhooks for your domains:
- Click Add tracking next to each of the domains that you want to connect.
- You have now added a Mailgun webhook to Apollo.
To delete a connected webhook from Apollo:
- Click Remove tracking.
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.
- If you try to add or remove a webhook from a domain that no longer exists in Mailgun, Apollo displays an 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.
- 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.
</>
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.
Enable Mailgun for a Mailbox
To enable Mailgun for a mailbox:
- Click Settings. Then, click the Mailboxes tab in your Personal Profile.
- Click the Additional Options (...) button to select the mailbox that you would like to enable with Mailgun. Then, click Send emails from Mailgun.
You have now enabled Mailgun for a mailbox in Apollo.
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.
Confirm You're Set Up
To confirm that you've integrated Mailgun correctly:
- Launch Apollo, click Settings, and then click the Mailboxes tab.
- You will see Send From Mailgun below the default email address. This confirms that you have set up Mailgun correctly 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.
Edit Your Daily and Hourly Send Rates
To adjust your daily and hourly send rates for a connected mailbox in Apollo:
- Click Settings. Then, click manage sending limits under each linked Mailbox.
- Click the mailbox for which you want to adjust the sending limits.
- From here, you can adjust the Emails sent per day and the Emails Sent Per Hour fields.
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.