Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.
JavaScript agent-skillsai-agentsai-seoclaudeclaude-codeclaude-code-pluginclaude-skillscodexcontent-marketingconversion-rate-optimizationcopywritingcursoremail-marketinggenerative-engine-optimizationgrowth-marketingmarketingmarketing-automationsaas-marketingseoskill-md
SendGrid
Email delivery platform for transactional and marketing emails.
Capabilities
| Integration | Available | Notes |
|---|---|---|
| API | ✓ | Mail Send API, Marketing API |
| MCP | - | Not available |
| CLI | - | Not available |
| SDK | ✓ | Official libraries for most languages |
Authentication
- Type: API Key
- Header:
Authorization: Bearer {api_key} - Get key: Settings > API Keys in SendGrid dashboard
Common Agent Operations
Send email
POST https://api.sendgrid.com/v3/mail/send
Authorization: Bearer {api_key}
{
"personalizations": [{
"to": [{"email": "[email protected]"}]
}],
"from": {"email": "[email protected]"},
"subject": "Welcome!",
"content": [{
"type": "text/html",
"value": "<h1>Welcome!</h1>"
}]
}
Send with template
POST https://api.sendgrid.com/v3/mail/send
{
"personalizations": [{
"to": [{"email": "[email protected]"}],
"dynamic_template_data": {
"name": "John",
"order_id": "12345"
}
}],
"from": {"email": "[email protected]"},
"template_id": "d-xxx"
}
Add contact to list
PUT https://api.sendgrid.com/v3/marketing/contacts
{
"list_ids": ["list-id"],
"contacts": [{
"email": "[email protected]",
"first_name": "John",
"last_name": "Doe"
}]
}
Search contacts
POST https://api.sendgrid.com/v3/marketing/contacts/search
{
"query": "email LIKE 'user@%'"
}
Read marketing campaigns (Single Sends)
The CLI's campaigns list and campaigns get <id> commands read Marketing Single Sends:
GET https://api.sendgrid.com/v3/marketing/singlesends?page_size=25
GET https://api.sendgrid.com/v3/marketing/singlesends/{single_send_id}
List responses contain result and _metadata; get responses contain the Single Send object. The CLI prints these provider responses without reshaping them. These commands use the current Marketing API, which is also used by the contact commands. Legacy Marketing Campaigns use the separate /v3/campaigns API and are not supported by these commands.
Get email statistics
GET https://api.sendgrid.com/v3/stats?start_date=2024-01-01&end_date=2024-01-31
Authorization: Bearer {api_key}
Get bounces
GET https://api.sendgrid.com/v3/suppression/bounces
Authorization: Bearer {api_key}
Get spam reports
GET https://api.sendgrid.com/v3/suppression/spam_reports
Authorization: Bearer {api_key}
Validate email
POST https://api.sendgrid.com/v3/validations/email
{
"email": "[email protected]"
}
Webhook Events
| Event | Description |
|---|---|
processed |
Email accepted |
delivered |
Email delivered |
open |
Email opened |
click |
Link clicked |
bounce |
Hard/soft bounce |
dropped |
Email dropped |
spamreport |
Marked as spam |
unsubscribe |
Unsubscribed |
Node.js SDK
const sgMail = require('@sendgrid/mail');
sgMail.setApiKey('SG.xxx');
await sgMail.send({
to: '[email protected]',
from: '[email protected]',
subject: 'Welcome!',
html: '<h1>Welcome!</h1>'
});
When to Use
- Transactional email at scale
- Marketing email campaigns
- Email validation
- Deliverability management
Rate Limits
- Free: 100 emails/day
- Paid: Varies by plan (up to millions/month)
Relevant Skills
- emails
- analytics