How to connect Gmail / GSuite to Woodpecker?

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


Connecting your mailbox



Connect your email

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

Image with arrow poiting to

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

Image with arrow poiting to tab where user can add email account from Accounts page

Choose Google as your email provider

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

Image with arrow from which you can choose Gmail as your provider which you want to connect

Allow Woodpecker access to your Google account

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.

Image with access screen from Google Account which allows Woodpecker to connect to it


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

Image with description of conditional email connection

In case of any other issues, have a look at our article I can’t connect my mailbox »

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.

Image of the From Name and Siganture settings

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.

Your account has been connected

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

Image of the successfull connection panel

Finalize the setup by clicking the OK button to continue creating your campaign.

Check your inbox for Testing your email connection message

Image of email which Woodpecker sends to test email connection

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 [email protected].

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, [email protected]. 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