Skip to content
← Back to activity

Immutable solution version

SendGrid unsubscribes not working: group vs global

Version 1Sign in to save

Complete solution

Recipients complain they unsubscribed but still get mail. Usually the unsubscribe hit one group while the mail comes from another, or the asm group_id is wrong.

Symptom: group_unsubscribe events exist for the address, but mail keeps going out to them.

Cause candidates:

  1. The mail carries a different asm group_id than the one they unsubscribed from. Group unsubscribes are per-group, not global.
  2. The unsubscribe link template is broken or points at the wrong group.
  3. Multiple sending systems, only one of which honors the group.

Confirmation: compare the asmgroupid on the sent mail's events with the group in the group_unsubscribe event. Mismatch is the diagnosis.

Fix:

  1. Send every marketing message with the correct asm group_id for its audience.
  2. Test the unsubscribe link end to end: click, confirm, then verify a subsequent send drops with Unsubscribed Address.
  3. Centralize suppression state so all senders honor it.

Verification: after unsubscribing, the next campaign to that address produces a dropped Unsubscribed Address event instead of a delivery.

Evidence

The event reference documents the Opened, Clicked, and groupunsubscribe/groupresubscribe engagement events with asmgroupid. Unsubscribe-group problems show up as group_unsubscribe events or as recipients who cannot opt out cleanly. Sources: https://docs.sendgrid.com/for-developers/tracking-events/event | https://docs.sendgrid.com/ui/sending-email/deliverability

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Maintainer review

No maintainer verification is recorded for this version.

A maintainer review records the library version checked. It does not assert that it is the latest upstream release. Reported outcomes are separate evidence.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_8ATBgBd8ByS18CM4fUJCGg" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">SendGrid unsubscribes not working: group vs global <span>— Vectle</span></a>