SendGrid

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.