SendGrid Connector

Intro

SendGrid is a cloud-based SMTP provider that allows users to send email without having to maintain email servers. Use Domo's SendGrid connector to retrieve data about your SendGrid account, such as statistics, bounces, spam reports, unsubscribes, and other information. To learn more about the SendGrid API, visit their page (https://sendgrid.com/docs/API_Reference/index.html).

You connect to your SendGrid account in the Data Center. This topic discusses the fields and menus that are specific to the SendGrid connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.

Prerequisites

To connect to your SendGrid account and create a DataSet, you must have a SendGrid username and password.

Connecting to Your SendGrid Account

This section enumerates the options in the Credentials and Details panes in the SendGrid Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.

Credentials Pane

This pane contains fields for entering credentials to connect to your SendGrid account. The following table describes what is needed for each field:

Field	Description
Username	Enter your SendGrid username.
Password	Enter your SendGrid password.

Once you have entered valid SendGrid credentials, you can use the same account any time you go to create a new SendGrid DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.

Details Pane

This pane contains a primary Reports menu, along with various other menus which may or may not appear depending on the report type you select.

Description

Report

Select the SendGrid report you want to run. The following reports are available:

Addresses on Account	Retrieves all the email addresses from the account.
All IPs	Retrieves a list of assigned and unassigned IPs. Includes warm-up status, pools, assigned subusers, and whitelabel info.
Advanced Statistics	Provides data about browsers and devices being used to open emails. Also provides statistics based on the geographic location or ISP.
Available Apps	Retrieves a list of available apps.
Blocks	Retrieves a list of blocks with addresses and response codes.
Blocks Count	Retrieves a count of blocks.
Bounces	Retrieves a list of bounces with addresses and response codes.
Bounces Count	Retrieves a count of bounces.
Current Time Zone	Returns the user's current time zone.
Existing Marketing Emails	Retrieves a list of existing marketing emails.
Email Addresses and Associated Fields for a Recipient List	Retrieves email addresses and associated fields for a recipient list.
Entries on a List	Retrieves the number of entries on a list.
General Statistics	Retrieves general statistics.
Get Warm-up Status for a Particular IP	Retrieves the warm-up status for a given IP.
Global Suppression Group Email Exist	Retrieves a global suppression group check.
IANA Time Zones	Retrieves a list of IANA time zones.
Invalid Emails	Retrieves a list of invalid emails with addresses and response codes.
Invalid Emails Count	Retrieves a count of invalid emails.
IP Addresses Belong to Which Pools	Shows which IP addresses belong to which pools.
IP Pools	Retrieves a list of IP pools.
IPs in a Specified Pool	Retrieves a list of IP addresses in a given pool.
IPs That Are Currently Warming Up	Retrieves all IPs that are currently warming up.
Information Associated with a Particular Address	Retrieves information associated with a particular IP address.
Lists Assigned to a Particular Marketing Email	Retrieves all lists assigned to a given marketing email.
Marketing Category List	Retrieves a list of marketing categories.
Recipient Lists	Retrieves a list of recipients.
Settings of an App	Retrieves settings for a given app.
Spam Details	Retrieves a list of spam reports.
Spam Counts	Retrieves a count of spam reports.
Suppression Groups	Retrieves all suppression groups associated with the user.
Single Suppression Groups	Retrieves all single suppression groups associated with the user.
Suppressed Addresses	Retrieves suppressed addresses for a given group.
Suppression Groups Associated with a Given Recipient Address	Returns suppression groups associated with a given recipient address.
Single Template	Retrieves single template details.
Scheduled Delivery Time for a Marketing Email	Retrieves the delivery time for a given marketing email.
Templates	Retrieves a list of templates.
Unsubscribes	Retrieves a list of unsubscribes with addresses.

Data Type

Select the data type you want to retrieve information for.

Aggregated By

Select how you want the data in your report to be aggregated. For example, if you select Day, the data will be broken down by day.

Start Date

Enter the start date for the data in your report. This should be paired with End Date.

End Date

Enter the end date for the data in your report. This should be paired with Start Date.

Month

Select the month you want to retrieve data for.

Week

Select the week you want to retrieve data for.

Year

Select the year you want to retrieve data for.

Metric

Select the metric you want to retrieve data for.

Country

Select the country you want to retrieve data for.

Days

Enter the number of past days you want to retrieve data for (including today). If you leave this blank, only today's information is returned.

Type

Select the type of blocks or bounces to count.

Recipient List Name

Enter the name of the list you want to retrieve data for. For example: pixlr news

Email Address

Enter the email address you want to retrieve data for.

Unsubscribed

Select True to retrieve a list of unsubscribed email addresses.

Aggregate

Select True if you want your report to show all-time totals.

Category Name

Enter the name of the category you want to retrieve detailed statistics for.

IP Address

Enter the IP address you want to retrieve information for. For example: 167.89.7.100

Pool Name

Enter the name of the pool you want to retrieve data for. For example: Bunderson Aquatic Center

Address Identity

Enter the address identity you want to retrieve data for. For example: Test Natalie

Marketing Email Address

Enter the marketing email address you want to retrieve data for.

App Name

Enter the app name you want to retrieve data for. For example: clicktrack

Group Name

Select the group you want to retrieve data for.

Template Name

Select the template you want to retrieve data for.

Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.

Knowledge Base