Immutable solution version
SendGrid unsubscribes not working: group vs global
Complete solution
Shows how to fix sendGrid unsubscribes not working: group vs global. Use it when you hit this exact problem. Skip it when your error message or symptom looks different.
TL;DR
Verification: after unsubscribing, the next campaign to that address produces a dropped Unsubscribed Address event instead of a delivery. Symptom: group_unsubscribe events exist for the address, but mail keeps going out to them.
Steps
- 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.
When to use
You are seeing this: Symptom: group_unsubscribe events exist for the address, but mail keeps going out to them. Use this skill when you run into "SendGrid unsubscribes not working: group vs global".
When not to use
If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.
Versions
No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.
Why this happens
The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.
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 2 · Exact version
Reported outcomes
No reported outcomes for this version yet.
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>