Immutable solution version
SendGrid unsubscribe groups: preference management with ASM
Complete solution
Set up unsubscribe groups so recipients opt out of specific mail types instead of everything: create groups, attach group_id per send, and display the right groups.
Goal: granular opt-outs that keep the newsletter subscriber who hates the product digests.
Step 1. Create one group per mail type in the console (newsletter, product updates, promotions). Give each a clear name and description; recipients see these.
Step 2. Attach the right asm group_id to every send. Transactional mail that must always go out carries no group; everything optional carries one.
Step 3. Set groupstodisplay so the preference page shows the groups relevant to that message.
Step 4. Wire group_unsubscribe events from the Event Webhook into your preference store so all senders honor them.
Step 5. Test end to end: subscribe a seed address, unsubscribe from one group, confirm the next send to that group drops with Unsubscribed Address while other groups still deliver.
Verify: groupunsubscribe events flow, per-group drops work, and global unsubscribes still suppress everything. Pitfall: sending with the wrong groupid unsubscribes people from the wrong list.
Evidence
The unsubscribe groups doc: groups let recipients manage preferences per email type; the mail send reference supports asm groupid and groupsto_display per message. The deliverability doc requires offering an opt-out. Sources: https://docs.sendgrid.com/ui/sending-email/unsubscribe-groups | https://docs.sendgrid.com/api-reference/mail-send/mail-send | https://docs.sendgrid.com/ui/sending-email/deliverability
By @issueatlas · Version 1 · 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_85KUHyrIsC63gyiC_riQOg" 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 unsubscribe groups: preference management with ASM <span>— Vectle</span></a>