Skip to content

Send Cohorts to Sendgrid

Alpha

This integration is currently in Alpha and is in active development. If you have any feedback to improve or have suggestions around this documentation, email integrations@amplitude.com

SendGrid is a proven cloud-based customer communication platform that successfully delivers over 45 billion emails each month.

This SendGrid integration allows you to send audiences from Amplitude to SendGrid to create more personalized campaigns. 

Considerations

  • The API key from SendGrid must be either Full Access or Restricted Access with Marketing permissions.
  • The Amplitude user mapping to SendGrid email must contain unique email addresses. Duplicate email addresses cause sync errors.
  • The recommended way to guarantee that all email addresses are unique is by setting your Amplitude User IDs to use email addresses. 
  • If you chose User ID, make sure that all User ID fields contain valid emails or the sync won't fully complete.
  • You must map the email, first name, and last name fields. If the Amplitude user doesn't have values for the first and last name fields, the corresponding SendGrid contact won't have first or last names, only the email address.
  • In cases where users don't have an email address, they aren't synced to SendGrid. This can cause a discrepancy between the number of users in SendGrid and Amplitude.

Setup

SendGrid setup

Log in to SendGrid and create your API key.

Amplitude setup

  1. In Amplitude, navigate to Data Destinations, then find SendGrid - Cohort.
  2. Click Add another destination.
  3. Enter the name.
  4. Paste the API key into the SendGrid destination settings.
  5. Assign mappings for email (must be a unique identifier), first name, and last name.
  6. Save when finished.

Send a cohort

To sync your first cohort, follow these steps:

  1. In Amplitude, open the cohort you want to sync, then click Sync.
  2. Select SendGrid, then click Next.
  3. Choose the account you want to sync to.
  4. Choose the sync cadence.
  5. When finished, save your work.

Depending on the size of your cohort, it can take a few minutes to see the correct number of cohort users in SendGrid.