SendGrid

SendGrid is an email delivery platform for transactional and marketing email. This bundle provides deliverability monitoring with suppression removal, marketing campaign management, contact list CRUD, and template browsing.

Deliverability & Suppressions

SendGrid tracks four distinct categories of problematic email addresses:

• Blocks — messages rejected by the receiving server due to policy, content, or reputation issues. Temporary; may clear on their own.
• Bounces — permanent delivery failures (mailbox doesn't exist, domain gone). High-priority to suppress.
• Spam Reports — recipients who flagged your email as spam. Highest-severity signal.
• Invalid Emails — addresses that failed format validation or pre-send checks.

Each category supports get by email (look up a specific address) and delete (remove from the suppression list to allow future delivery).

Suppressions prevent future sends to problematic addresses:

• Global suppressions apply across all email. An address on the global list receives nothing.
• Suppression groups (ASM groups) are category-scoped opt-outs — a user might unsubscribe from marketing but still receive transactional email. Each group has its own member list.

Marketing

• Contact Lists — static collections of recipients. Full CRUD: create, rename, delete (with optional contact cleanup).
• Segments — rule-based audiences (v2 segmentation) that dynamically filter contacts. Read-only.
• Single Sends — one-time marketing blasts with dedicated delivery/engagement stats (opens, clicks, bounces). Read-only.
• Campaigns — recurring or scheduled marketing programs. Read-only.
• Automations — trigger-driven email journeys with their own analytics. Stats read-only.
• Templates — reusable email designs. Filter by generations (legacy vs dynamic). Read-only.

CRUD Capabilities

Read + Delete (suppression management):

• Blocks, Bounces, Spam Reports, Invalid Emails — look up by email or list all, then delete specific addresses to re-enable delivery.

Full CRUD:

• Contact Lists — create, rename, delete (with optional contact cleanup).

Read-only:

• Global Suppressions, Suppression Groups, Suppression Group Members
• Segments, Single Sends, Campaigns, Automation Stats, Templates

Workflows

Deliverability audit: Pull blocks, bounces, spam reports, and invalid emails to assess sender health. Delete specific addresses to retry delivery after issues are resolved. Cross-reference with suppression groups to understand opt-out coverage.

Campaign performance review: List single sends and their stats, or pull automation stats for journey-based programs. Compare against suppression trends.

Contact management: Create and manage contact lists for targeting. Use segments for dynamic audience filtering. Delete lists when campaigns are complete (set delete_contacts=true to clean up orphaned contacts).

Pagination

Suppression endpoints (blocks, bounces, spam, invalid, global, group members) use offset/limit (default 500). Marketing endpoints (campaigns, single sends, lists, templates, stats) use page_size. Segments return all records in one call.

Gotchas

• Sender verification required: SendGrid rejects mail from unverified domains or senders. This is a platform prerequisite, not something these tools control.
• Suppression types are independent: An address can appear in blocks AND bounces AND spam reports simultaneously. Each category has its own list and removal semantics.
• Single Send vs Campaign: "Single send" = one-time blast. "Campaign" = scheduled/recurring. They use different API surfaces and stat endpoints.
• Scope-restricted credentials: SendGrid credentials carry granular permission scopes — a credential scoped to "Mail Send" only will return permission errors on suppression reads. Delete operations require additional write scopes; expect 403 if the configured credential lacks them.
• Deleting a suppression doesn't guarantee delivery: Removing an address from the bounce list allows a retry, but the underlying issue (bad mailbox) may still exist.