SendGrid Data Connector User Guide
Last updated
Twilio SendGrid is an email delivery platform for sending transactional and marketing email. The Power My Analytics SendGrid connector is in Beta: you can connect your SendGrid account today, and our team builds the connector's reports with you after you connect.
Note: SendGrid is a Beta connector. It is available in every Hub, where it appears in the source gallery with a BETA label. Its reports are built with the customers who connect it, so there are no SendGrid fields to add to a report yet. When you connect SendGrid, our team will reach out to learn which SendGrid data you need. We will expand this guide as the connector develops.
Prerequisites
Before you begin, make sure you have:
- A Twilio SendGrid account.
- A SendGrid API key. You will create it in SendGrid and paste it into your Hub when you add the source. We recommend a key with Full Access.
Adding SendGrid as a Data Source
- In your Power My Analytics Hub, select Sources from the menu.
- Click + Add new source and choose SendGrid from the gallery.
- In SendGrid, go to Settings > API Keys and click Create API Key. Name the key, choose Full Access, and create it. Copy the key right away, because SendGrid shows it only once.
- In the connection window in your Hub, enter your API Key and an Account Name to help you identify the account, then click Connect.
Power My Analytics checks your API key with SendGrid before it connects.
Key Reports and Fields
The SendGrid connector does not have reports yet. Its reports are built with the customers who connect it: when you connect SendGrid, our team is notified and will contact you to learn which SendGrid data you need, then build the connector's first reports around it.
What you'll see in your report
- Right after you connect, your SendGrid data source appears in your Hub, but there are no SendGrid fields to add to a report yet.
- There is no SendGrid data to report on in Data Studio or your other destinations until the first reports are built. We will update this guide with the available reports and fields, and how to build a report, once they are ready.
Limitations and Important Considerations
- Reports built after you connect: The SendGrid connector has no reports or fields until they are built for the customers who connect it.
- Beta connector: While SendGrid is in Beta, fields, configuration options, and behavior may change. If a field is renamed or removed, you may need to update the reports that use it.
What does this mean for me?
- Connecting SendGrid now lets our team build its first reports around the data you need.
- Until those reports are ready, view your SendGrid data in SendGrid itself.
Good to know
- How much history is available, and how often your SendGrid data refreshes, will be confirmed when the first reports are built.
If there is a SendGrid field or report you would like to see, please submit a ticket with a description or screenshot of what you need. Requests during Beta help us decide what to build first.
Troubleshooting
If something does not look the way you expect, start with Basic Troubleshooting. A few SendGrid patterns are worth checking first:
- The connection fails when you click Connect: Power My Analytics checks your API key with SendGrid before it connects. Create a new API key in Settings > API Keys (SendGrid shows each key only once) and paste it again.
- Your SendGrid data source has no fields: This is expected until the first SendGrid reports are built. Our team will contact you after you connect, and you can also submit a ticket to tell us which SendGrid data you need.
Still have questions? Submit a ticket and our support team will be glad to help. Please include the connector name and a short description of what you are seeing; screenshots are always helpful.