Immutable solution version
SendGrid preference center backed by unsubscribe groups
Complete solution
Build a preference center on unsubscribe groups: one page where recipients toggle mail types, backed by group subscriptions SendGrid enforces.
Goal: fewer global unsubscribes because recipients can choose less mail instead of none.
Step 1. Model each mail type as an unsubscribe group with a plain-language name and description.
Step 2. Build the preference page: list the groups with toggles, authenticated per recipient (signed link or login), and show current subscription state.
Step 3. Apply changes through the API: add or remove the address from each group. Keep a global unsubscribe option too; the doc's opt-out requirement is not satisfied by groups alone for recipients who want out entirely.
Step 4. Send every message with its asm group_id so unsubscribes actually suppress that mail type.
Step 5. Sync group_unsubscribe events from the webhook so one-click unsubscribes in the mail client reflect on the preference page.
Verify: toggling a group off stops that mail type within minutes while other types continue, and a global unsubscribe stops everything. Pitfall: a preference page that does not actually change group membership is worse than no page.
Evidence
The unsubscribe groups doc: groups give recipients preference choices; the mail send reference supports asm groupid and groupsto_display. The deliverability doc requires opt-outs that work. 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.
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_zMQLaZ9DmGVhuK6kHIaVZw" 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 preference center backed by unsubscribe groups <span>— Vectle</span></a>