skills.rest
openai
openaiOFFICIAL
Explore all skills by this author →
WebsiteGitHub

twilio-sendgrid-suppressions

Manage SendGrid email suppressions including bounces, blocks, spam reports, and unsubscribe groups.

5.3k|765|Updated Mar 4, 2026
Search Tags:#deliverability#unsubscribe#SendGrid#Twilio#bounces#asm groups#email suppressions
One-click install
npx skills add https://github.com/openai/plugins --skill twilio-sendgrid-suppressions
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: twilio-sendgrid-suppressions
Source: https://github.com/openai/plugins/tree/main/plugins/twilio-developer-kit/skills/twilio-sendgrid-suppressions
Command: npx skills add https://github.com/openai/plugins --skill twilio-sendgrid-suppressions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests.

What problem does it solve?

SendGrid automatically suppresses addresses that bounce, report spam, or unsubscribe, which protects sender reputation but can silently block legitimate sends. This Skill helps you inspect, manage, and safely remove suppression records while understanding the reputation impact of each action.

Core Features & Use Cases

  • Suppression Management: List and remove bounces, blocks, spam reports, invalid emails, and global unsubscribes via the SendGrid v3 API.
  • ASM Suppression Groups: Create category-based unsubscribe groups so recipients can opt out of one email category without being globally suppressed.
  • Reputation-Safe Operations: Guidance on auto-purge schedules, address allow lists, and the risks of re-sending to previously suppressed addresses.
  • Use Case: A customer reports they stopped receiving transactional emails. Use this Skill to check the bounce and block suppression lists, identify the cause, and remove the record after confirming the mailbox issue is resolved.

Quick Start

Ask the assistant to check whether a specific email address is on the SendGrid bounce suppression list and explain how to remove it safely.

Frequently Asked Questions about twilio-sendgrid-suppressions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I remove an email from the SendGrid bounce list?▼

Send a DELETE request to /v3/suppression/bounces/{email} with your SendGrid API key as a Bearer token. Confirm with the user first, since removing a bounce record allows re-sending to an address that previously failed delivery.

What is the difference between hard and soft bounces in SendGrid?▼

Hard bounces are permanent failures like an invalid mailbox and immediately suppress the address. Soft bounces are temporary failures like a full mailbox, and SendGrid retries delivery before eventually suppressing the address.

How do I let recipients unsubscribe from only one email category?▼

Create an ASM suppression group via POST /v3/asm/groups, then include asm.group_id in your Mail Send request. Recipients see a manage preferences link and can unsubscribe from that category without a global unsubscribe.

Does this work with the Twilio Email API?▼

No, this guidance applies only to the SendGrid API using an SG-prefixed API key against api.sendgrid.com. It is not applicable to the Twilio Email API at comms.twilio.com.

Can I bulk-remove SendGrid suppressions by domain?▼

No, SendGrid does not support bulk removal by domain. Suppressions must be removed individually by email address through the API.

Why did an address get suppressed from all my SendGrid emails?▼

Suppressions are global by default, so a single bounce or spam report blocks the address from all future sends. Use ASM suppression groups to scope unsubscribes to specific email categories instead.

Related Skills

Explore More Software Engineering Skills→
chunkydotdevchunkydotdev
2

suppression-lists

Manage email suppression lists across global, tenant, and campaign scopes.

Community
Advanced
twiliotwilio
28

twilio-sendgrid-email-send

Send transactional and bulk email via the SendGrid v3 Mail Send API.

Official
Advanced
chunkydotdevchunkydotdev
2

bounce-handling

Classify SMTP bounce codes and normalize provider webhook payloads.

Community
Advanced
Cure-Consulting-GroupCure-Consulting-Group

notification-architect

Design and optimize notification systems across push, in-app, email, and SMS channels.

Official
Advanced