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.
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:
- Link your mailbox: The integration only works if you have already connected your mailbox on Apollo.
- Have an active Mailgun account: Reach out to Mailgun Support if you have any questions getting started.
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.
Set Up 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:
- Launch Apollo and click Settings > Integrations.
- Click Connect beside Mailgun.
- Enter your Mailgun primary account API key, and click Link API key.
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.
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.
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.
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:
- Click Add tracking next to each of the domains that you want to connect.
- If you add or remove a webhook from a domain that no longer exists in Mailgun, Apollo displays an 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.
Next, enable Mailgun for your connected mailboxes.
Enable Mailgun for a Mailbox
To enable Mailgun for a mailbox:
- Launch Apollo and click Settings > Mailboxes.
- Click ... beside your mailbox, then click Send emails from Mailgun.
You have now enabled Mailgun for a mailbox in Apollo.
You can stop sending emails from Mailgun at any time. To do so, click ... beside your mailbox, then click Stop sending emails from Mailgun.
Confirm Setup
To confirm that you've integrated Mailgun correctly:
- Launch Apollo and click Settings > Mailboxes.
- Apollo displays Send From Mailgun below the default email address. This confirms that you have set up Mailgun correctly 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.
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.
- Select your mailbox.
- Adjust the emails sent per day and the emails sent per hour fields.
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.