Connecting SendGrid to Stitch is a three-step process:
- Add SendGrid as a Stitch data source
- Generate a Webhook URL
- Set up webhooks in SendGrid
Adding SendGrid as a Stitch Data Source
- On the Stitch Dashboard page, click the Add an Integration button.
- Click the SendGrid icon. If you need to use SendGrid's Zapier integration to complete the setup, click the Zapier icon instead.
- Enter a name for the integration. This is the name that will display on the Stitch Dashboard for the integration; it’ll also be used to create the schema in your data warehouse.
For example, the name “Stitch SendGrid" would create a schema called
stitch_sendgrid in the data warehouse. This schema is where all the tables for this integration will be stored.
- Click Save Integration.
Generating a SendGrid Webhook URL
Once Stitch has successfully saved and created the integration, you’ll be redirected to a page that displays your webhook URL and token (which is blurred in the image below):
Click the Copy button to copy it.
Note that this particular URL won’t display in Stitch again once you click Continue. Think of this URL like you would your login or API credentials - keep it secret, keep it safe. You can, however, generate another URL should you need it.
Once you’ve copied your webhook URL, click Continue to wrap things up in Stitch.
Setting Up Webhooks in SendGrid
The last step is to setup webhooks in your SendGrid account.
- Sign into your SendGrid account.
- In the pane on the left side of the screen, click Settings.
- In the Settings menu, click Mail Settings.
- Click Event Notification. This will expand the notification settings.
- Click On to enable event notifications.
- In the HTTP Post URL field, paste the Stitch-generated webhook URL.
- In the Actions section, select the action types you want to send to Stitch:
- When finished, click the checkmark on the right side of the notification settings.
SendGrid Data & Replication
After the setup for SendGrid is complete, your webhook data will be continuously replicated through Stitch. To learn more about how Stitch replicates SendGrid webhook data and our recommended strategy for querying, check out the Expected SendGrid Data article.