List Armor

SendGrid Integration

Automatically sync unsubscribes, bounces, and spam complaints from SendGrid to your suppression lists.

On this page

Overview

The SendGrid integration uses Event Webhooks to automatically add email addresses to your suppression lists when recipients unsubscribe, report spam, or experience hard bounces.

Real-Time Sync

Events processed within seconds

Verified Webhooks

Signature validation supported

Auto-Suppress

Configurable event handling

Prerequisites

  • A SendGrid account with Event Webhook access
  • A List Armor campaign with at least one suppression list
  • Admin access to configure SendGrid webhooks

Setup in List Armor

  1. Navigate to your campaign and click ESP Integrations
  2. Click Add Integration and select SendGrid
  3. Choose the Target Suppression List where opt-outs will be added
  4. Configure which events to auto-suppress:
    • Hard bounces (recommended)
    • Spam complaints (recommended)
    • Unsubscribes (recommended)
  5. Optionally add a Webhook Secret for signature verification
  6. Save the integration and copy the Webhook URL
Tip: The webhook URL is unique to your integration and includes your integration ID.

Configure SendGrid

  1. Log in to your SendGrid dashboard
  2. Navigate to Settings → Mail Settings → Event Webhooks
  3. Click Create new webhook
  4. Paste your List Armor webhook URL in the Post URL field
  5. Select the events to send:
    • Bounced — Hard and soft bounces
    • Spam Reports — Spam complaints
    • Unsubscribes — Group unsubscribes
  6. If using signature verification, enable Signed Event Webhook and copy the verification key to List Armor
  7. Set the webhook to Enabled and save

Supported Events

SendGrid Event List Armor Action Default
bounce (hard) Add to suppression list Enabled
bounce (soft) Logged only (not suppressed) N/A
spamreport Add to suppression list Enabled
unsubscribe Add to suppression list Enabled
group_unsubscribe Add to suppression list Enabled

Testing

After configuring the webhook, verify it's working:

  1. Send a test email through SendGrid to an address you control
  2. Trigger an unsubscribe or mark as spam
  3. Check your List Armor integration for the Last webhook received timestamp
  4. Verify the email appears in your target suppression list
Note: SendGrid also provides a "Test Your Integration" button in the webhook settings that sends sample events.

Troubleshooting

  • Verify the webhook is enabled in SendGrid
  • Check that the correct events are selected
  • Ensure the webhook URL is correct (no typos)
  • Check SendGrid's Event Webhook activity log for errors

  • Ensure the verification key in List Armor matches SendGrid exactly
  • Re-copy the key from SendGrid (avoid extra spaces)
  • Try disabling signature verification temporarily to confirm webhooks work

  • Check that auto-suppress is enabled for the event type
  • Verify the target suppression list is active
  • Check the integration's event log for processing errors

Need Help?

Having trouble with your SendGrid integration? Our support team can help.

Contact Support