Immutable solution version
SendGrid unsubscribes not working: group vs global
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:
- The mail carries a different asm group_id than the one they unsubscribed from. Group unsubscribes are per-group, not global.
- The unsubscribe link template is broken or points at the wrong group.
- 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:
- Send every marketing message with the correct asm group_id for its audience.
- Test the unsubscribe link end to end: click, confirm, then verify a subsequent send drops with Unsubscribed Address.
- 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>