📮

SendGrid Integration

Beta

Native connector

Import SendGrid bounces and spam reports into your suppression list (and trigger bounce-guarantee refunds), and verify Marketing Campaigns contacts.

Connect SendGrid

Dashboard → Integrations → SendGrid

Dashboard

Bounce guarantee

Connect your sending provider and bounced "deliverable" addresses are refunded automatically

How it works

Connect with

API key

How to Connect

In RocketVerifier open Dashboard → Integrations → SendGrid, paste the credentials below (a SendGrid API key) and click Connect. They are validated against the platform before anything is saved.

Field	Required	Where to find it
API key	Required	SendGrid → Settings → API Keys. Suppressions read access is needed for the bounce feed, Marketing read access for contact syncs.
Event webhook verification key	Optional	Settings → Mail Settings → Event Webhook → Signed Event Webhook (public key). Needed to accept real-time events.

Credentials are stored encrypted and are only ever sent to the platform's own API hosts.

What It Syncs

Sources

All Marketing Campaigns contacts or any list (read through SendGrid's contact export).

Incremental syncs

SendGrid has no change filter, so an incremental sync reads the whole source; contacts verified within the skip window are still skipped.

Schedules & Credits

Schedule: Manual only, Daily, Weekly or Monthly. Each run syncs the source chosen in the settings; Sync now starts one immediately. Only one sync runs per integration at a time.
Mode: Full re-checks every contact in the source except those verified in the last N days (default 30, 0-365); Incremental only checks contacts changed since the last sync.
Each sync creates a regular verification job: 1 credit per unique address, and unknown results are refunded when it completes. If the balance is too low the sync stops with insufficient_credits before anything is charged.
Results are written back when the job completes; the sync history in the dashboard shows updated, failed and skipped counts per run.

Write-back

Contact syncs are read-only: results appear in RocketVerifier, nothing is written back to SendGrid.

Bounce Feed Setup

The webhook URL is shown on the integration page in the dashboard and has the form:

https://api.rocketverifier.com/webhooks/connectors/sendgrid/{integration_id}

Copy the webhook URL shown on the integration page in the dashboard.

In SendGrid open Settings → Mail Settings → Event Webhook, paste the URL as the HTTP POST URL and select the Bounced, Blocked and Spam Reports events.

Turn on Signed Event Webhook, copy the verification key and paste it into the integration's *Event webhook verification key* field. Unsigned or wrongly signed events are rejected.

bounce → hard bounce, blocked → soft bounce, spamreport → complaint. Events are de-duplicated on sg_event_id, so SendGrid's retries are harmless.
Even without the webhook, RocketVerifier reads the bounce and spam-report suppression lists once a day.
Hard bounces and complaints are added to your auto-managed suppression list Bounces & complaints (auto); soft bounces are recorded only. Hard bounces of addresses we verified as deliverable are refunded under the bounce guarantee.

Beta: the SendGrid connector is new. Sync reports list every contact that could not be updated; please tell us if something looks wrong.

Need Help?

Having trouble connecting SendGrid? We're here to help.

Contact Support All Integrations