How to connect Sendgrid 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 Sendgrid, it’s better to come up with a subdomain (for example, m.customer-success.us), and set it up in Sendgrid settings. This will also require you to set up the subdomain in your DNS settings panel.

Sendgrid and Woodpecker: Step-by-Step setup

1. Set up and warm up your domain

Before you start using Sendgrid 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 Sendgrid account. Also, note that Sendgrid gives quite fresh IP addresses that also need to be warmed up first.

Here you can check how to do it:  Warming Up an IP Address >>

2. Add a subdomain to Sendgrid

To start with, you will need to create a subdomain in Sendgrid. You can do it in Settings -> Domains -> New Whitelabel.

SendGrid 2017-10-31 13-45-31.png

SendGrid 2017-10-31 13-48-25.png

To create new domain white label add a prefix in the Subdomain field and provide the name of your domain in the Domain field.

Ex. if your domain name is:

“customer-success.us”

in Sendgrid you can use a subdomain:

“s.customer-success.us”

SendGrid 2017-10-31 13-55-33.png

Please remember that the subdomain address will not be visible to your prospects. You will use it just for Sendgrid to make sure your domain is safe and your deliverability rate stays high.

3. Copy DNS records from Sendgrid to your domain settings

After you create a subdomain, you will see the DNS records that you will need to add to your domain settings.

You will need to:

- add Sendgrid’s record to your main SPF

- create a TXT record for your subdomain

- add three CNAME records

Sendgrid panel

SendGrid 2017-10-31 14-07-19.png

You will need to create a new TXT record for your subdomain, which should look like this: v=spf1 include:sendgrid.net ~ all

Your domain panel

If you have an SPF record set for your domain, you just add  include:sendgrid.net to the record in your DNS in domain settings.

Name.com - Domain Name Registration 2017-10-31 14-04-59.png

Fill in all the data and click on “Add record” to save the record for the subdomain.

CNAME records

The next step is to set up CNAME records in your domain settings. Go to your DNS settings and define a new CNAME record for your subdomain. Please copy and paste the data that SendGrid will provide you with.

Your domain panel

Name.com - Domain Name Registration 2017-10-31 14-29-28.png

The next step is to go to Sendgrid and validate all CNAME data that you’ve just set up in your domain settings panel. If you did everything right, you’ll see a green mark next to it.

Sendgrid panel

SendGrid 2017-10-31 14-36-14.png

4. Connecting Sendgrid to Woodpecker

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

Customer Success proactive touch - Woodpecker 2017-10-31 14-41-27.png

Firstly, you need to connect your IMAP. To do this please fill out all empty fields.

For connecting SMTP you will need an API KEY from Sendgrid. You can create it in API Keys -> Settings.

SendGrid 2017-10-31 14-58-21.png

SendGrid 2017-10-31 14-59-25.png

To create an API key, you will need to provide API Key Name. It’s the name of your subdomain.

Please remember that Sendgrid will generate and show an API Key for you just once. In case you don’t copy it, you will need to create it again.

SendGrid 2017-10-31 15-05-03.png

Provide the API Key from Sendgrid to Woodpecker, after choosing Sendgrid as the SMTP service in SMTP settings in Woodpecker.

Customer Success proactive touch - Woodpecker 2017-10-31 15-07-04.png

If all data provided in SMTP settings in Woodpecker is valid, you’ll get a notification about successfully connecting your email address to Woodpecker, Sendgrid included.

Customer Success proactive touch - Woodpecker 2017-10-31 15-28-17.png

Still need help? Contact Us Contact Us