Linking SendGrid as a source

Alpha release

This source is currently in alpha. The interface and available tables may change.

Enter your SendGrid API key to pull your SendGrid data into the PostHog data warehouse.

Adding a data source

Go to the sources tab of the data pipeline section in PostHog.
Click + New source and then click Link next to SendGrid.
You need an API key from SendGrid. Create one in your SendGrid account settings under Settings → API Keys. Grant the following read access (Restricted Access) so the key can reach the data you want to sync:
- Suppressions — bounces, blocks, invalid emails, spam reports, global unsubscribes, unsubscribe groups
- Marketing — marketing lists
- Template Engine — templates
Back in PostHog, paste the key in the API key field and click Next.
Select the tables you want to sync, set the sync method and frequency, then click Import.

Once the syncs are complete, you can start using SendGrid data in PostHog.

Table	Description	Sync method
`bounces`	Suppressed addresses that hard or soft bounced	Incremental
`blocks`	Addresses blocked from receiving mail	Incremental
`invalid_emails`	Addresses rejected as invalid	Incremental
`spam_reports`	Recipients who marked your mail as spam	Incremental
`global_unsubscribes`	Globally unsubscribed addresses	Incremental
`unsubscribe_groups`	Unsubscribe (suppression) groups	Full refresh
`marketing_lists`	Marketing contact lists	Full refresh
`templates`	Email templates (legacy and dynamic)	Full refresh

Incremental tables sync only new or updated records on each run. Full refresh tables reload all data on each sync.

Option	Type	Required
`API key`	password	Yes