How to connect Gmail to Woodpecker

This guide will take you through the process of connecting your Google account to Woodpecker.


Connecting your mailbox

1. Click ‘Connect your email’

Once your campaign is created, open it (click Campaigns in the black bar at the top, then click your campaign), and click Connect your email, right below the campaign's name.

Alternatively: you can go to Settings (expand the menu in the upper right and click Settings), then click the green button Add Email Account.

2. Choose Google as your email provider

Woodpecker has native, one-click integration with Google’s Gmail.

Note that when you select Gmail you will be informed about the sending limits for this provider. The default limit in Woodpecker will be set according to your choice.

3. Choose ‘Automatic connection’

Choose Automatic connection and the App will auto-detect settings and quickly configure the email for you.

4. Click Allow

Once you click Add email, you will be asked to allow Woodpecker to access your Google Account and read, send, delete as well as manage your email.

Remember to turn off the 2-step verification login for the connection time. Once your account will be connected - you can turn it back on.


  • Woodpecker may connect your email address conditionally. Check what that means and how to fix it here.

  • In case of any other issues, have a look at our article I can't connect my mailbox.

5. Set your “From name” and “Signature”

This screen allows you to set the sender's name that will be visible to your recipients, and a signature that will be attached to emails in your campaigns.

You can skip this step, and set both later by clicking “set it later in Settings”.

6. Click “Save”

… and give Woodpecker a few moments to complete the setup. Afterward, you will be able to select this email as a sender in your campaign.

7. Your account has been connected

Now you are able to select your Gmail address as a sender in your campaign.

8. Finalize the setup

  • Click “OK” to continue creating your first campaign. 
  • Click “DELIVERABILITY REPORT” to check information about the correctness of SPF and DKIM when connecting the mailbox.

9. Check your inbox for "Testing your email connection" message

Once you connect your email account to Woodpecker, the App will send you the message confirming the successful connection. You will see it in your primary inbox. Its subject is "Testing your email connection with" and should look like the one on the image above. 

Don't worry, this is an automatic message sent from our internal email address 

In case you're connecting a mailbox to a company under the Agency panel, we will send the message from the email account connected to your Agency account. The content of that message can be crafted by you in the Agency panel settings. Have a look at the Agency Quickstart Guide »

You can't find the test message in your inbox?
  1. You might have been connected conditionally.
  2. Check your SPAM or junk folder.
  3. If the message is there, move it to the primary inbox.
  4. Try connecting your mailbox again. Remember to remove any labels or forwarding options. Learn why »
  5. Your email address should be connected successfully!

Testing your connection – campaign email

Woodpecker will be testing your email connection and deliverability every day by sending the test email to another of our internal email addresses, Don't worry! While you have active campaigns, we will be sending the email once a day to check if your deliverability settings, such as SPF records or DKIM, have been set up correctly. Although a copy of those emails can be different than the original copy of your campaign, we do it to make sure that you're up-to-date with your domain settings. Here you can read more about our deliverability checks and report »


Deliverability is the number of emails that have reached the recipients' inboxes compared to the number of sent messages overall. The goal is to have as many of your emails land in your prospects' inboxes rather than going to spam folders. To ensure high deliverability rates, make sure you set up SPF and DKIM correctly. Click here to learn more about the importance of deliverability. 


Also, don't forget about the domain and email address warm-up.


Q: Why do I need to set up SPF and DKIM?

To avoid spam issues. How? SPF records tell mailboxes which hosts are allowed to send mail from a given domain. You can add SPF records in your DNS settings to easily prove your authenticity and help your email deliverability. 

Q: How can I set up SPF and DKIM?

Check Google instructions on how to set up SPF here and DKIM here.

Q: What SPF should I add?

If you're using Google Apps (G Suite) to send your messages, you should include the following record:

v=spf1 ~all

Alternatively: if you connected your Gmail through the 'Settings' menu, you can now select it in your campaign. Simply go to ‘Campaigns’ list, open the campaign and select the newly connected Gmail address in ‘Send from’.

Still need help? Contact Us Contact Us