How to connect Mailgun to Woodpecker

This guide assumes that you have at least basic understanding of what a domainDNSSPF and DKIM are. If you're not sure what they taste best with, please take a moment to read about them, following the links for each.

Before you start, note that we use these two terms in the guide:

  1. Primary domain
  2. Subdomain

Primary domain is the one you use on a daily basis to send business emails from Woodpecker (for example, customer-success.us).

When using Mailgun, it’s better to come up with a subdomain (for example, m.customer-success.us), and set it up in Mailgun settings. This will also require you to set up the subdomain in your DNS settings panel.

Can I use the same domain name for Mailgun and for Google Apps (or another email server)?

To create a subdomain in Mailgun, add a prefix before your primary domain name in the Mailgun panel.

That way, if your primary domain name is “customer-success.us”, add a prefix, such as “m.” (followed by a dot) to your primary domain name.

So if your domain name is:

“customer-success.us”

in Mailgun you would use a subdomain:

“m.customer-success.us”

Important: the subdomain address will not be visible to your email recipients. You only use it for Mailgun to be able to set all the required records properly in order to keep your deliverability as high as possible.

Mailgun and Woodpecker: Step-by-Step setup

1. Set up and warm up your domain

Before you start using Mailgun to send your emails, it’s crucial to have a properly prepared domain. We recommend using a separate domain for cold outreach, so if you don’t have one yet, set it up.

Choose whatever domain registrar and/or DNS server you prefer. Configure your DNS and take some time to warm up the domain before sending your cold emails.

How to warm up a domain? >>

Once your domain is ready for sending emails, you can set it up with your Mailgun account.

2. Add a subdomain to Mailgun

Domains: List - Mailgun 2017-10-30 11-35-01.png

In the Mailgun “Domains” panel, click “Add New Domain”. Type in the name of your subdomain. As described above, it’s safer to use a subdomain rather than your primary domain address.

So let’s say, the name of your domain is customer-success.us. In Mailgun, type in m.customer-success.us – this will be your subdomain for cold emails.

Domains: New - Mailgun 2017-10-30 11-37-53.png

3. Check your domain’s configuration

  1. Log into your domain management account at your domain registrar.
  2. Verify your DNS records.

First, establish where your DNS records are being hosted. DNS records are usually hosted by your domain registrar, for example, GoDaddy or Name.com.

However, sometimes you can buy a domain from a domain registrar like GoDaddy or any other, but your DNS server is hosted externally by a web hosting company.

4. Copy DNS records from Mailgun to your domain settings

This step is necessary to allow Mailgun to send emails from your domain on your behalf.

It will require you to copy 4 types of records from Mailgun to the DNS settings of your domain:   SPF, DKIM, MX and CNAME.

The screenshots below come from the panel at Name.com. We use it only as an example here. If you use another domain registrar, you will see a different panel, but look for the same type of settings.

4.1 Open the DNS settings at your domain account

Name.com - Domain Name Registration 2017-10-27 12-12-47.png

4.2 Check your SPF records at your domain account

DNS setup for your domain should now include Mailgun in the SPF records of your domain.

It will read “include:mailgun.org”, just like in the screenshot below:

DNS settings panel (here: Name.com)

Name.com - Domain Name Registration 2017-10-27 16-08-00.png

4.3 Find your TXT records in Mailgun

TXT RECORDS: SPF and DKIM values (obligatory)

Mailgun Dashboard

Domains: Verify - Mailgun 2017-10-30 11-42-39.png

4.4  Copy those TXT records from Mailgun to the DNS settings of your domain

SPF

Copy the SPF record from Mailgun and paste it into your DNS records in domain settings.

DNS settings panel (here: Name.com) Name.com - Domain Name Registration 2017-10-30 11-47-42.png

Note: It’s important to make sure the SPF record is set up for both your domain and subdomain.

So first, copy the SPF value from Mailgun and paste it into the DNS records of your domain (i.e. customers-success.us).

Next, define a new record for your subdomain:

  • choose Type: TXT
  • paste the subdomain as Host.
  • paste the SPF record as Answer.

Click on “Add record” to save the record for the subdomain (e.g. m.customer-success.us).

DNS settings panel (here: Name.com)

Name.com - Domain Name Registration 2017-10-30 12-04-36.pngDKIM

Copy the DKIM record from Mailgun into your DNS records. It should be the exact same record in both places.

DNS settings panel (here: Name.com)

Name.com - Domain Name Registration 2017-10-30 11-46-15.png

MX & CNAME records (optional)

The MX and CNAME records are optional, but:

If you want to use the Mailgun bounce tracking, you need to set up the MX record only for your subdomain.

If you plan on tracking opens, clicks, and including the unsubscribe links in your emails, you need to set up the CNAME record.

Important: Woodpecker tracks opens and clicks and it allows you to add the Unsubscribe link to your emails, so if you’d rather use the built-in tools in Woodpecker (which is recommended), you can skip this entire step.

MX

Set two MX records only for your subdomain:

In Mailgun, you’ll find two MX records. You need to copy both of them to your DNS settings.

Mailgun dashboard

Domains: Verify - Mailgun 2017-10-27 15-41-15.png

How to copy an MX record from Mailgun panel to DNS settings:

Go to your DNS settings, and define a new record only for your subdomain:

  • choose Type: MX
  • paste the subdomain as Host
  • paste the MX record from Mailgun as Answer

Click on “Add record” to save the record for the subdomain (i.e m.customer-success.us).

Remember to perform that action for both MX records. Copying just one is not enough. Here’s what it should look like in your DNS server settings.

DNS settings panel (here: Name.com)

Name.com - Domain Name Registration 2017-10-30 12-08-19.png

CNAME

Copy the CNAME record from Mailgun only to your subdomain in DNS settings.

First, copy the CNAME value from Mailgun.

Mailgun Dashboard

Domains: Verify - Mailgun 2017-10-27 15-54-31.pngSecond, go to your DNS settings and define a new CNAME record for your subdomain:

- choose Type: CNAME

- paste the subdomain as Host

- paste the CNAME record from Mailgun as Answer

DNS settings panel (here: Name.com)

Name.com - Domain Name Registration 2017-10-30 12-09-44.png

4.5 Check the settings you’ve just updated by clicking on “Check DNS Records Now”

If you did everything right, you’ll see a green mark next to it.

Mailgun dashboard

Domains: Settings - Mailgun 2017-10-30 12-19-36.png

5. Connecting Mailgun to Woodpecker

5.1 Choose your email provider or click ”Other (IMAP)”, and then select the option Advanced - I want to use another SMTP server.
Woodpecker panel

Woodpecker.co - Woodpecker 2017-10-30 12-46-41.png

5.2 Fill out IMAP server data. Note: this will be empty only if you chose “Other” in the dropdown list. If you’re using a default IMAP from Google, Office 365, or Exchange, these will be set to their respective default for you.

Woodpecker.co - Woodpecker 2017-10-30 12-54-06.png

5.3 Connect your SMTP from Mailgun.

In the SMTP Server data section in Woodpecker, choose Mailgun from the dropdown list of SMTP providers, like in the screenshot below.

Woodpecker panel 

First, copy the API Base URL from Mailgun, and paste it in Woodpecker into the API Domain field.

Domains: Settings - Mailgun 2017-10-30 16-23-22.png

Second, copy the API key from Mailgun, and paste it in Woodpecker into the API Key field.

There you go! You’ve just connected your email account with Mailgun SMTP to Woodpecker.

To test the SMTP connection, create a campaign in Woodpecker, add at least one email address as your prospect, and click “Save & Send” to send a test email to this address.

Still need help? Contact Us Contact Us