kbarbel640-del Send Email with SendGrid
Overview
SendGrid provides a single Mail Send endpoint for sending email via the v3 API. The Node SDK (@sendgrid/mail) is the recommended integration for JavaScript/TypeScript.
Use this skill when:
- Sending transactional emails (welcome, password reset, receipts)
- Sending simple notifications
- You need basic text/HTML emails with optional attachments
Quick Start
- Detect project language (package.json, requirements.txt, go.mod, etc.)
- Install SDK (preferred) or use cURL - See references/installation.md
- Prepare message with
from,to,subject, andtextorhtml - Send and handle errors (retry on 429/5xx)
Required Parameters
| Parameter | Type | Description |
|---|---|---|
from |
string | Sender email (must be verified) |
to |
string or string[] | Recipient email(s) |
subject |
string | Email subject |
text or html |
string | Email body content |
Optional Parameters
| Parameter | Type | Description |
|---|---|---|
cc |
string or string[] | CC recipients |
bcc |
string or string[] | BCC recipients |
reply_to |
string | Reply-to address |
attachments |
array | Base64-encoded attachments |
template_id |
string | Dynamic template ID (if using templates) |
dynamic_template_data |
object | Template data (if using templates) |
Minimal Example (Node.js)
import sgMail from '@sendgrid/mail';
sgMail.setApiKey(process.env.SENDGRID_API_KEY!);
await sgMail.send({
from: 'Support <support@winkintel.com>',
to: 'vince@winkintel.com',
subject: 'Hello from SendGrid',
text: 'This is a test email.',
html: '<p>This is a test email.</p>',
});
Templates (Dynamic Templates)
If using SendGrid Dynamic Templates, supply template_id and dynamic_template_data instead of html/text.
await sgMail.send({
from: 'Support <support@winkintel.com>',
to: 'vince@winkintel.com',
templateId: 'd-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
dynamicTemplateData: { first_name: 'Vince' },
});
Best Practices (Short)
- Always set both
textandhtmlwhen possible (deliverability + accessibility). - Retry only on 429 or 5xx errors with exponential backoff.
- Use verified senders; unverified domains will fail.
- Avoid fake addresses at real providers; test with addresses you control.
For deeper details, see:
- references/best-practices.md
- references/single-email-examples.md