SendGrid

Send transactional emails, manage templates, and view delivery statistics.

Install

amodal connect sendgrid

Authentication

Bearer token authentication.

• SENDGRID_API_KEY — SendGrid API key

Endpoints

Send

• POST /v3/mail/send — Send an email (confirmation)

Statistics

• GET /v3/stats — Retrieve global email statistics

Templates

• GET /v3/templates — List all transactional templates
• GET /v3/templates/{id} — Retrieve a specific template
• PATCH /v3/templates/{id} — Update a template (confirmation)
• DELETE /v3/templates/{id} — Delete a template (confirmation)

Suppression

• GET /v3/suppression/bounces — List bounced email addresses
• GET /v3/suppression/blocks — List blocked email addresses
• GET /v3/suppression/spam_reports — List spam reports
• DELETE /v3/suppression/bounces/{email} — Remove from bounce list (confirmation)
• DELETE /v3/suppression/blocks/{email} — Remove from block list (confirmation)
• DELETE /v3/suppression/spam_reports/{email} — Remove a spam report (confirmation)

Activity

• GET /v3/messages — Search recent email activity

Entities

• mail, send, stat, template, suppression, bounce, block, spam_report

Rules

• API rate limit: ~600 requests/minute; activity feed (GET /v3/messages) is limited to 10 requests/minute
• Hard bounces permanently suppress the address — future sends are silently dropped; sending to suppressed addresses still counts against daily limits
• Email activity (GET /v3/messages) retains data for only 7 days; statistics are available for up to 36 months
• Always include both text/plain and text/html content types when sending; max 1000 recipients per API call, 30 MB max email size