Integrate Mailgun with Apollo

Article author
Sarah Malone
Updated

Overview

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

 
It's in the Plan

Access to the Mailgun integration depends on your Apollo plan. If you need access, upgrade your plan. If you have questions about upgrading, reach out to the Apollo sales team.

If you created your Mailgun account with a domain from an EU server, you can't integrate your Mailgun account with Apollo.

Before you set up the Mailgun integration:

 
The Mailgun Mandate

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

Check out the following sections to integrate Mailgun with Apollo.

Back To Top

Set Up the Integration

 
Important Info About the Integration

If you use Mailgun for open tracking, Apollo doesn't sync click events from Mailgun like self-opens or bot-opens. Apollo only tracks process events from Mailgun like dropped or not sent messages, bounced messages, and spam blocked messages. However, Mailgun does count bot and self-opens in open tracking, which could lead to an inflated report on click events. To avoid this, consider using Apollo for open tracking.

Additionally, Apollo doesn't support IP allowlisting in Mailgun. If you enable IP allowlisting, you can't deliver Mailgun messages through Apollo. For more information on IP allowlisting, check out IP Reputation Management on Mailgun Support.

To integrate Mailgun with Apollo:

  1. Launch Apollo and click Settings > Integrations.
  2. Click Connect beside Mailgun.

Connect Mailgun Button on Integration Page

  1. Enter your Mailgun primary account API key, and click Link API key.

Link Mailgun Button

 
API Key FYI

Apollo doesn't support Mailgun domain sending keys. The primary account API key must be a private key. If you're not sure where to find your API key, check out Where Can I Find My API Key? on Mailgun Support or refer to their documentation on the different API keys in Mailgun.

You have now connected Mailgun to Apollo. Apollo automatically displays all the domains connected to your Mailgun account.

Mailgun domains

If you add or delete a domain in Mailgun after connecting, the change doesn't immediately reflect on Apollo. Click Refresh List to get updates.

 
Domain Management

For more information about how to add and delete domains in Mailgun, check out How do I add or delete a domain? on Mailgun Support.

Next, add Mailgun webhooks in Apollo for your connected domains.

Back to Top

Add Mailgun Webhooks for Your Domains

To ensure full functionality of the Mailgun integration, add a webhook for each domain you use to send emails from in Apollo. Once enabled, you can track the performance of your sequences and identify bounced emails to improve your email deliverability rates.

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

  1. If you add or remove a webhook from a domain that no longer exists in Mailgun, Apollo displays an error message.

Error message

You have now added a Mailgun webhook to Apollo. To delete a connected webhook from Apollo, click Remove tracking.

You can only connect 1 webhook per domain with the Mailgun integration. If you encounter the following error, delete the non-Apollo webhook from Mailgun or manually add the webhook in Mailgun.

Error message 2

Next, enable Mailgun for your connected mailboxes.

Back to Top

Enable Mailgun for a Mailbox

To enable Mailgun for a mailbox:

  1. Launch Apollo and click Settings > Mailboxes.
  2. Click ... beside your mailbox, 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!

You can stop sending emails from Mailgun at any time. To do so, click ... beside your mailbox, then click Stop sending emails from Mailgun.

Back to Top

Confirm Setup

To confirm that you've integrated Mailgun correctly:

  1. Launch Apollo and click Settings > Mailboxes.
  2. Apollo displays 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?

Set up a custom tracking subdomain to protect your domain reputation. Tracking subdomains forward the emails that you send from Mailgun onto your primary domain. Make sure you link both mailboxes with Apollo. If you don't connect your primary domain with Apollo, but forward the emails you send via Mailgun to it, those emails will not appear in Apollo. Check out Link Your Mailbox for more information.

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

  1. Select your mailbox.

Mailbox

  1. Adjust the emails sent per day and the emails sent per hour fields.

Email Sending Limits

 
Looking for sent emails?

Did you know? Emails sent via Mailgun don't appear in your mailbox sent folder.

You have now edited your email sending limits on Apollo.

Back to Top