On this page

SendGrid

SendGrid is a cloud-based customer communication platform that delivers over 45 billion emails each month. This integration lets you 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.
  • Cohorts can't have duplicate emails. Duplicates cause sync errors with SendGrid.
    • To guarantee unique email addresses, set your Amplitude User IDs to use email addresses.
  • All exported emails must be valid, or the sync fails.
  • 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.
  • Users without an email address aren't synced to SendGrid. This can cause a discrepancy between the number of users in SendGrid and Amplitude.
  • In SendGrid, emails aren't case-sensitive. For example, "User@Company.com" and "user@company.com" sync to the same contact (user@company.com).
  • Amplitude creates new contacts for users that aren't SendGrid contacts, and doesn't duplicate existing contacts. Amplitude adds both types of users to the list.
  • Cohort names can't exceed 85 characters. Cohorts with names longer than 85 characters fail during export.

Set up the integration

SendGrid setup

Log in to SendGrid and create your API key. The API key type must be either Full Access or Restricted Access with Marketing permissions.

Amplitude setup

  1. In Amplitude Data, click Catalog and select the Destinations tab.
  2. In the Cohort section, click SendGrid.
  3. Click Add another destination.
  4. Enter the name.
  5. Paste the API key into the SendGrid destination settings.
  6. Assign mappings for email (must be a unique identifier), first name, and last name.
  7. Save when finished.

Send a cohort

  1. In Amplitude, open the cohort you want to sync, then click Sync.
  2. Select SendGrid, then click Next.
  3. Choose the account 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.

Was this helpful?