> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://sendgrid.com/docs/API_Reference/index.html "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](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").

## Prerequisites

To connect to your SendGrid account and create a DataSet, you must have an API Key.

## 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](https://domo-support.domo.com/s/article/360042926274?language=en_US "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:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> Field </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> Description </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> API Key </p></td><td colspan="1" rowspan="1"><p> Enter the API Key. </p></td></tr></tbody></table>

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](https://domo-support.domo.com/s/article/360042926054?language=en_US "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.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select the SendGrid report you want to run. The following reports are available: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><p><b> Report Name </b></p></td><td colspan="1" rowspan="1"><p><b> Description </b></p></td></tr><tr><td colspan="1" rowspan="1"><p> Alerts </p></td><td colspan="1" rowspan="1"> Returns all the alerts on account. </td></tr><tr><td colspan="1" rowspan="1"><p> All IPs in Warming Up </p></td><td colspan="1" rowspan="1"> Returns all IP addresses that are currently warming up. </td></tr><tr><td colspan="1" rowspan="1"><p> Blocks </p></td><td colspan="1" rowspan="1"><p> Returns a list of all email addresses that are currently in the blocks list. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Bounces </p></td><td colspan="1" rowspan="1"> Returns all bounces on account. </td></tr><tr><td colspan="1" rowspan="1"><p> Campaigns </p></td><td colspan="1" rowspan="1"> Returns a list of all campaigns. </td></tr><tr><td colspan="1" rowspan="1"><p> Email Statistics By Browser </p></td><td colspan="1" rowspan="1"> Returns email statistics segmented by browser type. </td></tr><tr><td colspan="1" rowspan="1"><p> Email Statistics By Client Type </p></td><td colspan="1" rowspan="1"> Returns email statistics segmented by client type. </td></tr><tr><td colspan="1" rowspan="1"><p> Email Statistics By Country and State </p></td><td colspan="1" rowspan="1"> Returns email statistics segmented by country and state/province. </td></tr><tr><td colspan="1" rowspan="1"><p> Email Statistics By Device Type </p></td><td colspan="1" rowspan="1"> Returns email statistics segmented by the device type. </td></tr><tr><td colspan="1" rowspan="1"><p> Email Statistics By Mailbox Provider </p></td><td colspan="1" rowspan="1"> Returns email statistics segmented by recipient mailbox provider. </td></tr><tr><td colspan="1" rowspan="1"><p> Email Statistics By Specific Client Type </p></td><td colspan="1" rowspan="1"> Returns email statistics segmented by a specific client type. </td></tr><tr><td colspan="1" rowspan="1"><p> Email Statistics For Categories </p></td><td colspan="1" rowspan="1"> Returns all email statistics for categories. </td></tr><tr><td colspan="1" rowspan="1"><p> Get Warmup Status for a Particular IP </p></td><td colspan="1" rowspan="1"> Returns the warmup status for a specific IP address. </td></tr><tr><td colspan="1" rowspan="1"><p> Global Email Statistics </p></td><td colspan="1" rowspan="1"> Returns all of the global email statistics between a given date range. </td></tr><tr><td colspan="1" rowspan="1"><p> Global Suppressions </p></td><td colspan="1" rowspan="1"> Returns a list of all email address that is globally suppressed. </td></tr><tr><td colspan="1" rowspan="1"><p> Invalid Emails </p></td><td colspan="1" rowspan="1"> Returns a list of all invalid email addresses. </td></tr><tr><td colspan="1" rowspan="1"><p> List All IPs </p></td><td colspan="1" rowspan="1"> Returns a list of all assigned and unassigned IPs. </td></tr><tr><td colspan="1" rowspan="1"><p> List All IPs In a Specified Pool </p></td><td colspan="1" rowspan="1"> Returns a list all of the IP addresses that are in a specific IP pool. </td></tr><tr><td colspan="1" rowspan="1"><p> Marketing Campaigns Recipients </p></td><td colspan="1" rowspan="1"> Returns all of marketing campaigns recipients. </td></tr><tr><td colspan="1" rowspan="1"><p> Pending Teammates </p></td><td colspan="1" rowspan="1"> Returns a list of all pending teammate invitations. </td></tr><tr><td colspan="1" rowspan="1"><p> Segments </p></td><td colspan="1" rowspan="1"> Returns all of the segments. </td></tr><tr><td colspan="1" rowspan="1"><p> Sender Identities </p></td><td colspan="1" rowspan="1"> Returns a list of all sender identities that have been created for an account. </td></tr><tr><td colspan="1" rowspan="1"><p> Spam Reports </p></td><td colspan="1" rowspan="1"> Returns all the spam reports. </td></tr><tr><td colspan="1" rowspan="1"><p> Subuser Reputations </p></td><td colspan="1" rowspan="1"> Returns the reputations for subusers. </td></tr><tr><td colspan="1" rowspan="1"><p> Subusers </p></td><td colspan="1" rowspan="1"> Returns a list of all of subusers. </td></tr><tr><td colspan="1" rowspan="1"><p> Sum of Email Statistics </p></td><td colspan="1" rowspan="1"> Returns the total sum of each email statistic for every category over the given date range. </td></tr><tr><td colspan="1" rowspan="1"><p> Suppression Groups Associated with the User </p></td><td colspan="1" rowspan="1"> Returns a list of all suppression groups created by the user. </td></tr><tr><td colspan="1" rowspan="1"><p> Suppressions </p></td><td colspan="1" rowspan="1"> Returns a list of all suppressions. </td></tr><tr><td colspan="1" rowspan="1"><p> Teammates </p></td><td colspan="1" rowspan="1"> Returns a list of all current teammates. </td></tr><tr><td colspan="1" rowspan="1"><p> Templates </p></td><td colspan="1" rowspan="1"> Returns all transactional templates. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Data Type </p></td><td colspan="1" rowspan="1"><p> Select the data type you want to retrieve information for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Aggregated By </p></td><td colspan="1" rowspan="1"><p> Select how you want the data in your report to be aggregated. For example, if you select <b> Day </b>, the data will be broken down by day. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Start Date </p></td><td colspan="1" rowspan="1"><p> Enter the start date for the data in your report. This should be paired with <b> End Date </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> End Date </p></td><td colspan="1" rowspan="1"><p> Enter the end date for the data in your report. This should be paired with <b> Start Date </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Month </p></td><td colspan="1" rowspan="1"><p> Select the month you want to retrieve data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Week </p></td><td colspan="1" rowspan="1"><p> Select the week you want to retrieve data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Year </p></td><td colspan="1" rowspan="1"><p> Select the year you want to retrieve data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Metric </p></td><td colspan="1" rowspan="1"><p> Select the metric you want to retrieve data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Country </p></td><td colspan="1" rowspan="1"><p> Select the country you want to retrieve data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days </p></td><td colspan="1" rowspan="1"><p> 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. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Type </p></td><td colspan="1" rowspan="1"><p> Select the type of blocks or bounces to count. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Recipient List Name </p></td><td colspan="1" rowspan="1"><p> Enter the name of the list you want to retrieve data for. For example: <span class="mt-font-courier-new"> pixlr news </span></p></td></tr><tr><td colspan="1" rowspan="1"><p> Email Address </p></td><td colspan="1" rowspan="1"><p> Enter the email address you want to retrieve data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Unsubscribed </p></td><td colspan="1" rowspan="1"><p> Select <b> True </b> to retrieve a list of unsubscribed email addresses. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Aggregate </p></td><td colspan="1" rowspan="1"><p> Select <b> True </b> if you want your report to show all-time totals. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Category Name </p></td><td colspan="1" rowspan="1"><p> Enter the name of the category you want to retrieve detailed statistics for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> IP Address </p></td><td colspan="1" rowspan="1"><p> Enter the IP address you want to retrieve information for. For example: <span class="mt-font-courier-new"> 167.89.7.100 </span></p></td></tr><tr><td colspan="1" rowspan="1"><p> Pool Name </p></td><td colspan="1" rowspan="1"><p> Enter the name of the pool you want to retrieve data for. For example: <span class="mt-font-courier-new"> Bunderson Aquatic Center </span></p></td></tr><tr><td colspan="1" rowspan="1"><p> Address Identity </p></td><td colspan="1" rowspan="1"><p> Enter the address identity you want to retrieve data for. For example: <span class="mt-font-courier-new"> Test Natalie </span></p></td></tr><tr><td colspan="1" rowspan="1"><p> Marketing Email Address </p></td><td colspan="1" rowspan="1"><p> Enter the marketing email address you want to retrieve data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> App Name </p></td><td colspan="1" rowspan="1"><p> Enter the app name you want to retrieve data for. For example: <span class="mt-font-courier-new"> clicktrack </span></p></td></tr><tr><td colspan="1" rowspan="1"><p> Group Name </p></td><td colspan="1" rowspan="1"><p> Select the group you want to retrieve data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Template Name </p></td><td colspan="1" rowspan="1"><p> Select the template you want to retrieve data for. </p></td></tr></tbody></table>

## 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](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").
