Run better email campaigns on SendGrid with up-to-date customer data from your data warehouse
|Type||Description||Supported Sync Modes||API Reference|
|Contacts||Sync data from any source to Contacts in SendGrid||Upsert||Contacts docs|
For more information about sync modes, refer to the sync modes docs.
Connect to SendGrid
Go to the Destinations overview page and click the Add destination button. Select SendGrid and click Continue. You can then authenticate Hightouch to SendGrid by entering a SendGrid API Key.
To create an API Key in SendGrid, follow the steps outlined in the SendGrid documentation.
Once you've set up your SendGrid destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page and click the Add sync button to begin. Then, select the relevant model and the SendGrid destination you want to sync to.
Upsert is the only available sync mode for the SendGrid destination. Use this sync mode to update existing contacts and insert new ones into SendGrid.
To match rows from your model to contacts in SendGrid, you need to select the model column that contains your contacts' email.
John@example.com, this would create two separate contacts.
You can sync columns from your model to SendGrid default and custom fields.
Tips and troubleshooting
If you encounter an error or question not listed below and need assistance, don't hesitate to . We're here to help.
Invalid list id
When you run a sync to SendGrid for the first time, Hightouch creates a new contact list. You can find this list on the Contact Lists page in your SendGrid workspace. If you delete this contact list, future sync runs will reject all rows with the
invalid list id error.
To resolve this issue, create a new sync. This allows Hightouch to create a new contact list, which must exist for the sync to run successfully.
Hightouch provides complete visibility into the API calls made during each of your sync runs. We recommend reading our article on debugging tips and tricks to learn more.
Hightouch can alert you of sync issues via Slack, PagerDuty, SMS, or email. For details, please visit our article on alerting.