SendGrid

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
SENDGRID_API_KEYYesSendGrid API key (starts with SG.) Docs.

Setup

  1. Sign in to SendGrid: Go to https://app.sendgrid.com and sign in. A free tier account is sufficient for testing.
  2. Verify a sender: Under Settings → Sender Authentication, verify a single sender address or authenticate your domain. Mail Send rejects unverified 'from' addresses.
  3. Create an API key: Open Settings → API Keys (https://app.sendgrid.com/settings/api_keys) and create a key with Full Access, or Restricted Access including Mail Send, Marketing, Template Engine, and Stats.
  4. Set the environment variable: Add the key to your .env as SENDGRID_API_KEY=SG....
  5. Verify access: Run List Templates to confirm the key works, then send a test email to yourself.

Provider notes

  • SendGrid authenticates with 'Authorization: Bearer SG.xxx'
  • Mail Send returns HTTP 202 with an empty body on success
  • Upsert Contacts is asynchronous - changes can take a few minutes to appear in List Contacts

Provider API reference.

Tools

ToolAccessDescription
Send Email<br /><code className="reference-identifier">sendgrid__send_email</code>WriteSend email
List Contacts<br /><code className="reference-identifier">sendgrid__list_contacts</code>ReadList contacts
Search Contacts<br /><code className="reference-identifier">sendgrid__search_contacts</code>ReadSearch contacts
Upsert Contacts<br /><code className="reference-identifier">sendgrid__upsert_contacts</code>WriteStart contact upsert
List Templates<br /><code className="reference-identifier">sendgrid__list_templates</code>ReadList templates
Get Email Stats<br /><code className="reference-identifier">sendgrid__get_email_stats</code>ReadGet email stats

Verify the connection

Call a read tool such as sendgrid__list_contacts with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.