SendGrid

SendGrid delivers transactional and marketing email. Sender authentication (domain, single sender) is required. Suppressions (blocks, bounces, spam reports, invalid emails) prevent sending to problematic addresses. Singlesends are marketing campaigns.

Data Model

• Blocks are emails that were blocked (content, etc.). sendgrid_list_blocks.
• Bounces are hard bounces (invalid address). sendgrid_list_bounces. Add to suppression to stop retries.
• Spam reports are user-reported spam. sendgrid_list_spam_reports.
• Invalid emails are malformed or rejected. sendgrid_list_invalid_emails.
• Suppressions (global, group) block sending. sendgrid_list_global_suppressions; suppression groups via sendgrid_list_suppression_group_members.
• Lists are contact lists. sendgrid_list_lists. Segments are dynamic. sendgrid_list_segments.
• Singlesends are one-off marketing sends. sendgrid_list_singlesends; stats via sendgrid_list_singlesend_stats.
• Campaigns are multi-send marketing. sendgrid_list_campaigns.
• Automations are triggered flows. sendgrid_list_stats_automations for automation stats.

Gotchas

• Sender verification: Must verify domain or single sender before sending. Unverified = reject.
• Suppression types: Blocks, bounces, spam, invalid are separate. Global suppression applies to all; groups are scoped.
• Singlesend vs Campaign: Singlesend = one-time; Campaign = recurring/scheduled.
• Rate limits: SendGrid has daily and per-second limits. Check response headers.