Connecting to SendGrid

Introduction

This article shows you the steps required to integrate Gravity SMTP on your website with the SendGrid service by Twilio. SendGrid offers a free service up to a limited quantity of emails per day, which can make it a low commitment option for small websites with only modest outgoing email needs.

Integration Steps

To allow Gravity SMTP to send messages from your website via the SendGrid service, you will need to complete the following steps:

  1. Create a Twilio SendGrid account (as required for the plan you are using).
  2. Authenticate a domain as Sender Identity in SendGrid.
    Adding a “sender identify” to your SendGrid account is required in order to prove ownership of the email address and domain that outgoing messages will be representing. You must complete this step before configuring the SendGrid Integration within Gravity SMTP. Refer to this help guide for instructions on how to complete this step.
  3. Obtain your SendGrid API key.
    This will be required in settings to create the link between SendGrid and your website via Gravity SMTP. Refer to this help guide for instructions on how to find that API key in your SendGrid account.
  4. Complete the Gravity SMTP Settings screen.
    Go to Gravity SMTP → Settings → Integrations and click the settings cog on the Sendgrid card. This will open a pop-up modal with all the fields required for SMTP to connect with SendGrid. See below for a description of these settings.
  5. Click Save Changes button.
    You should be returned to the Settings card page, and the Configured text should show at the bottom of the settings card for SendGrid. If your settings card still shows Not Configured, then there was an issue. Check your settings.
Image showing that the connection is configured.
  1. Enable the integration using the on-off toggle (if you are ready to use it).
    Click the toggle on the settings card to turn on SendGrid integration. This will show SendGrid as Connected. You can then test using the Gravity SMTP Tools, or using your website. Note that only one integration can be active at a time, so toggling one integration on will toggle any other active integration to off.
Image showing that the connection is cinnected.

SendGrid Settings Reference

Configuration

TagDescription
SendGrid API KeyThe key provided by SendGrid that is used to authenticate with the SendGrid API.
See the “Steps” section for the process on obtaining this.

General Settings

Image showing SendGrid General Settings.
TagDescription
From EmailThe from: email associated with outgoing messages. This email address or associated domain will need to have a verified sender identity within SendGrid. See the “Steps” section for the process on verifying a sender.
Only applied when from: property is not explicitly set in the message being processed.
Force EmailIf enabled, the From Email will override any plugin settings for all outgoing email messages.
From NameThe from: name associated with outgoing messages.
Only applied when from: property is not explicitly set in the message being processed.
Force NameIf enabled, the From Name will override any plugin settings for all outgoing email messages.