SendGrid is another supported Transport you can use in Rock. Like the other options described above, be sure to evaluate each service before deciding which is the best fit for your organization’s needs.

Most of the configuration you’ll need to do will be with SendGrid. You can learn more and get started for free by visiting https://sendgrid.com/. After you’re set up with SendGrid, you’ll need to provide the following in Rock:

• Base URL: The default URL 
• API Key: SendGrid will provide this when you’re set up with their service. This is required for Rock and SendGrid to communicate.

Like other Communication Transports, you can also choose whether SendGrid should track email opens, clicks and unsubscribes. Note that Rock only supports HTTP/S (and not SMTP) for SendGrid.

Setting up SendGrid

The first step will be getting your API Key. Log in to your SendGrid account and navigate to Settings > API Keys. Click the button for Create API Key.

We recommend giving Restricted Access permission. Also, make sure Mail Send is assigned full access as pictured below.

Be sure to copy the API key when it is presented to you. SendGrid warns that you won’t see it again, and that's true. If you lose the key, you’ll have to create a new one.

Once you’ve got your API key, you’ll need to add it to Rock. Inside Rock, navigate to Admin Tools > Settings > Communication Transport > SendGrid HTTP and add the Base URL and your API Key as pictured below.

Next, you’ll need to update the Communication Medium configuration in Rock. Navigate to Admin Tools > Settings > Communication Mediums and access the Email entry. Change the Transport Container to the SendGrid HTTP transport configured in the prior step.

With the above configuration in place, head back over to SendGrid to set up the Event Webhook. You can access this in SendGrid under Settings > Mail Settings > Event Settings. Click the pencil icon for the Event Webhook row to access its settings.

The Event Webhook settings in SendGrid will look like those pictured below. The HTTP Post URL will be formatted as shown, with your Rock URL followed by Webhooks/TwilioSendGrid.ashx. Twilio owns SendGrid, so don’t be concerned about the Twilio part of the webhook.

Note that Processed and Deferred currently have no functionality in Rock and can be left disabled. Be sure that the Event Webhook Status is set to Enabled before saving.

To track opens and clicks, you’ll want to enable those Tracking options in SendGrid. Under Settings click on Tracking to enable these options by clicking the pencil icon. The example below shows what the page will look like after open and click tracking have been enabled.

Lastly, add your information to the Sender Authentication settings. This helps with deliverability. An example of the setup is pictured below, but if you’re not sure what you need there’s a helpful link at the top of page.

Don’t be discouraged if your emails aren’t popping into inboxes right away. There are a variety of factors that can cause delays ranging from a few minutes to several hours. You can click on the Activity menu item in SendGrid to search for emails you’ve sent and view details on what may be holding them up. Be patient, because sometimes there’s a delay between sending an email and seeing it in the Activity list.