Skip to main content

How to Connect SendGrid to SendX

Learn how to integrate SendGrid with SendX to automatically sync your contacts, lists, bounces, suppressions, and email templates. Set up takes under 5 minutes.

S
Written by Suket Bhola
Updated today

Connecting SendGrid to SendX brings your contacts, lists, bounce data, global suppressions, and email templates into SendX. Bounce and unsubscribe status from SendGrid is carried over automatically so your SendX sending reputation stays clean from day one.

When you'd use this

You've been sending through SendGrid and want to move to or add SendX for campaign management. This integration migrates your audience, suppression data, and templates so you can start sending from SendX without losing any deliverability-critical information.

What data gets synced

When you connect SendGrid, SendX imports the following:

  • Lists — All SendGrid contact lists are created as SendX lists with the same names.

  • Bounces — Emails on SendGrid's bounce list are marked as bounced in SendX. These contacts will not receive campaigns.

  • Global suppressions (unsubscribes) — Emails on SendGrid's global suppression list are marked as unsubscribed in SendX.

  • Contacts — Email, first name, last name, company, and other fields are mapped to SendX contact fields. Bounce and suppression status is applied automatically. All other fields become custom fields.

  • Email templates — SendGrid templates (including HTML content) are fetched and created as SendX templates, prefixed with SENDGRID_.

Synced contacts are automatically tagged via_sendgrid so you can identify, filter, and segment them at any time.

Single Sends, API keys, subusers, and other SendGrid objects are not synced.

Before you start

Make sure you have:

  • An active SendGrid account with contacts

  • Ability to create an API key in SendGrid with Marketing (Full Access) and Suppressions (Read Access) permissions

  • A SendX account with permission to manage integrations

Step-by-step setup

1. Go to Settings in your SendGrid dashboard and click on API Keys.

2. Click Create API Key.

3. Enter a name for the API key and select the Custom Access option.

4. Enable Full Access on Marketing and Read Access on Suppressions, then click Create & View.

5. Copy the API key.

6. In your SendX account, go to Settings > Integrations and click Enable against the SendGrid integration.

7. Paste the API key into the API Key field and click Save.

8. You're all set! The integration will begin syncing data. The time required depends on the number of contacts and templates in your SendGrid account.

After the initial sync, SendX checks for new and updated contacts from SendGrid every hour.

Important notes

  • Bounces and suppressions are respected. Contacts on your SendGrid bounce or global suppression list are marked accordingly in SendX and will not receive campaigns.

  • Templates are prefixed SENDGRID_. Synced templates appear in SendX with the prefix so you can identify where they came from. If a template already exists in SendX with the same name, it is updated.

  • Template merge tags may need updating. SendGrid templates are synced with their original HTML. If they use SendGrid-specific merge syntax, you'll need to update those to SendX merge tags before sending.

  • Custom fields are created automatically. Any SendGrid contact field that doesn't map to a standard SendX field is created as a custom field in SendX.

  • Contacts are deduplicated by email. If a contact already exists in SendX, their record is updated — not duplicated.

  • Deleting the integration stops future syncs but does not remove contacts, lists, or templates already in SendX.

Common questions

How long does the initial sync take?

Small accounts typically sync within a few minutes. Larger accounts with many contacts and templates may take longer.

Will my existing SendX contacts be overwritten?

No. SendX merges by email address. Existing contacts are updated — nothing is deleted.

Why do I need Marketing (Full Access) and Suppressions (Read Access) specifically?

Marketing access is needed to read your contact lists and contact data. Suppressions access is needed to read your bounce and global unsubscribe lists so SendX can correctly mark those contacts and protect your sending reputation.

Will my SendGrid templates look the same in SendX?

The HTML is synced as-is. Templates using SendGrid-specific merge tags (like {{first_name}}) will need those tags updated to SendX merge tag format before sending.

What happens if I delete the integration?

Contacts, lists, and templates already synced into SendX remain. Deleting the integration only stops future syncs.

Did this answer your question?