In this article, we'll review how to set up the SendGrid integration in Keela and authenticate your domain.
Set Up the SendGrid Integration
Before you start, we recommend reviewing the requirements for the SendGrid integration. In addition, we also suggest that you make and keep a copy of your existing DNS records in a separate location in case you need to revert to your previous settings.
To continue, you'll need a few key pieces of information:
- Login credentials and access to DNS management settings for your custom domain
- Administrative access to the Organization Settings for your organization
- Keela user account with an email address that matches the custom domain
- Organization-wide email address that matches the custom domain (optional)
Once you have that information, you can get started!
Note: We suggest that you have your website or email administrator, or someone else who is familiar with email configuration, to proceed from this point. Incorrect configuration can disrupt delivery of your emails sent from inside or outside of Keela.
Connect your domain
To integrate with SendGrid, head over to 'Organization Settings' by clicking on the organization name in the top right corner of Keela. Select the 'Integrations' tab.
Find the SendGrid widget and click on the 'Connect Domain' button.
You will be prompted to add your organization's domain. Make sure not to include http:// - just the domain name itself (i.e. yourorganization.org). Click 'Save'.
Add records to your domain DNS settings
On the Authenticate Email Domain screen, you will see three categories of information: domain authentication, link branding, and reply tracking.
Navigate to your domain and locate the DNS management tool. In GoDaddy, this is found under 'Additional Settings' and is called 'Manage DNS'. Open your DNS records.
Add a DNS record, and select the proper type of record. For this integration, you will need to set up 5 CNAME records and 1 MX record.
Copy and paste the information from the Authenticate Email Domain screen in Keela to your domain manager. Start with the first CNAME record.
The 'Host' information should be input into the corresponding field, and the 'Points To' information should be entered into the field for destination information. GoDaddy calls this field 'Points to', but other domain providers may call it something else. The TTL field does not need to be changed.
Click 'Save' when finished. Repeat this for all 5 CNAME records.
For the MX record, select 'MX' from the Type field and input the host and destination information. In the Priority field, type in "10".
Note: Many domain providers do not require you to enter in your domain after the Host information. If you find that you have trouble setting up your SendGrid integration, you may wish to try adding your domain (e.g. keela-emails.domain.com) and/or verifying the information required with your domain provider.
Authenticate your email domain
When you have added all six DNS records to your domain manager, return to Keela. Click the 'Authenticate' button. This will verify your DNS records.
It can take some time for your records to update. If the Status for each record does not appear as "Verified" the first time, we recommend returning in a few hours to double-check and re-authenticate.
After you have set up the integration and authenticated your domain, when you return to 'Authenticate Domain' and click the 'Authenticate' button, the integration confirmation message will appear.
Set Up Your Outgoing Email Addresses
Now that you have authenticated your domain, you can choose to use your personal email address when sending emails and e-blasts, as long as it is from the same domain that was authenticated, and also set an additional organization-wide email address for use.
Use your personal email address
If the email that you used to sign up for Keela with has the same domain as the one you have authenticated, you can choose to use it as your outgoing email address.
To turn on this functionality, click on 'Personal Settings'.
Select the 'Notifications & Emails' tab. Scroll to Other Email Settings at the bottom of the page.
You will see a setting called 'Outgoing Email Address' which shows your keela.co email address. Click the slider to the right of the setting to turn it on. This will change the email displayed.
Use an organization-wide email address (optional)
If you have an organization-wide email that you want to use to send newsletters or other mass communication, click on 'Edit Organization Email'.
Indicate the email address that you want to use for sending organization-level emails.
This email will replace the default organization email address ending in keela.co, and you can use this email in the future to send e-blasts, instead of your individual organization email.
Does your domain provider look different? Want to learn more about DNS records? Check out some of these resources.
Changing DNS Settings
Advanced DNS Settings (Squarespace)
Add an MX record (GoDaddy)
Add a CNAME record (GoDaddy)
How to update the DNS records for my domain (Web Hosting Canada)
Understanding DNS Records
DNS Records Explained (Bluehost Web Hosting)
Common DNS Request Types (OpenDNS)