Set Up, Configure, and Troubleshoot Your SendGrid Account

Article author
Matthew Charles
  • Updated

Overview

SendGrid allows you to send a higher volume of emails that can bypass the regular sending limits that major email providers have in place. Your ability to send more emails increases when you set up and integrate a SendGrid account with Apollo.

 
More on Sending Limits

For more information on sending limits, please see the "Email Sending Limits Overview" article.

Refer to the sections below for information about how to prepare your SendGrid account to integrate with Apollo.

Back to Top

SendGrid Setup

 
SendGrid Account

Please note, if you do not have a SendGrid account, visit the "Getting started with the SendGrid API" article on the SendGrid knowledge base for more information on account creation.

Back to Top

Domain Authentication

Domain authentication shows email providers that SendGrid has your permission to send emails on your behalf. In the SendGrid application, you can provide the necessary information to point your DNS entries from your DNS provider to SendGrid. In SendGrid, under Settings, click Sender Authentication and then click Authenticate Your Domain.

Auth Domain

Use the drop-down to identify your DNS host. Click Yes or No to answer if you would like link branding. For more information on link branding, refer to the "What is Link Branding" article on the SendGrid knowledge base. Click Next.

Link Branding

Fill in your From Domain. For example, jane.doe@company.com and then click Next.

Email Domain

You must manually install the CNAME records that SendGrid provides. If you don't have access to your company's DNS records, you can email the CNAME records to a coworker.

 
Tutorial Videos

For more information on how to add your CNAME to some popular DNS service providers, check out these videos.

CNAME

Once you add the CNAME records to your DNS host, return to the Sender Authentication Page and click Verify.

Back to Top

Troubleshoot SendGrid Domain Authentication

You may encounter an authentication error when you try to link SendGrid to Apollo.

Error

You must verify all domains that are used as both mailboxes and as user logins over Apollo before completing the integration. You must authenticate through SendGrid:

  • All domains you're using for user logins
  • All domains you're using for multiple mailboxes linked to Apollo, as well as aliases.

If you have multiple mailboxes linked to Apollo, they must all be verified through SendGrid.

You won't be able to link your SendGrid account to Apollo until you complete this. The Sender Authentication section in SendGrid shows your domains as Verified if your setup was successful.

Verified

Check out the "Sender Identity" article on the SendGrid knowledge base for more information.

Back to Top

Generate a SendGrid API Key

You must generate a SendGrid API key before you can integrate with Apollo. To generate an API key, load SendGrid and expand the Settings accordion. Then, click API Keys.

API Keys

Click Create API Key.

Create API Key

Type a name in the API Key Name field. Then, choose the level of access you want to give SendGrid in the API Key Permissions section.

API Key Name

To customize your SendGrid access permissions, choose Restricted Access. From there, you can choose the access details for SendGrid.

API Key Access

 
Settings You'll Need if You Want to Succeed!

Please note, to gain full functionality of the SendGrid-Apollo integration, you must enable full access to the following API settings in SendGrid before moving forward:

  • Mail Send Mail send setting
  • Event Notifications Event notifications setting
  • Open Tracking Open tracking setting

After you make your access selection, click Create & View.

Create & View

In the modal, click the API Key to copy it to your clipboard and then click Done.

Done

 
API Key

Please note, you should place a copy of your API Key in a safe place. Once you have closed the API Key window, you cannot return for a copy of it from SendGrid again.

Configure Event Reporting

 
Sync Tracking Statistics with Apollo

Please note, you need to enable open tracking, click tracking, and event webhook (event reporting) to sync all the tracking statistics between SendGrid and Apollo.

You must configure the Event Webhook to sync your SendGrid statistics with Apollo. Once you update the configuration, the statistics sync with Apollo moving forward. The sync is not retroactive and previous statistics need to be reviewed directly on SendGrid.

Launch SendGrid, then expand the accordion for Settings. Click Mail Settings.

Mail Settings

Click the Edit icon for "Event Webhook."

Event Webhook

In the Event Webhook modal, copy and paste the following URL into the HTTP Post URL field: https://api.apollo.io/v1/emailer_message_events/log_sendgrid_events

HTTP Post URL

Scroll to the Events to be POSTed to your URL section and click the checkboxes for the following:

  • Deliverability Data
    • Processed
    • Dropped
    • Deferred
    • Delivered
    • Bounced
  • Engagement Data
    • Opened
    • Clicked
    • Unsubscribed

POSTed

Click Enabled under Event Webhook Status.

Event Webhook Status

Configure SendGrid Tracking

Launch SendGrid, then click Tracking under Settings.

Tracking

Confirm that you've enabled Open Tracking and Click Tracking.

Tracking Settings

If either is disabled, click the Edit symbol.

Edit

Then click Enable.

Enable

 
IP Whitelisting

Please note, Apollo does not support IP whitelisting in SendGrid. If you enable IP whitelisting, you cannot deliver SendGrid messages through Apollo. For more information on IP whitelisting, please read this SendGrid article.

Back to Top


Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request