Building Your App › Integrations
SendGrid Integration
Send emails at scale with SendGrid
What is SendGrid?
SendGrid is one of the most popular email services, trusted by companies worldwide. It's perfect for sending lots of emails reliably - from welcome emails to marketing campaigns.
Perfect for:
- High-volume email sending
- Transactional emails (receipts, resets, etc.)
- Marketing campaigns
- Email analytics and tracking
What You'll Need
SendGrid Account
Sign up at sendgrid.com - free plan available!
Verify Sender
Verify your email or domain
API Key
Create an API key
Step 1: Get Your SendGrid API Key
Create Account
- Go to signup.sendgrid.com
- Sign up for free account
- Verify your email
Free Plan Includes:
- 100 emails per day, forever!
- Full API access
- Email analytics
Verify Your Sender
Note
Quick Start: Verify a single email (easiest) Production: Verify your domain (best for serious apps)
Option 1: Single Sender (Quick)
- In Dashboard → Settings → Sender Authentication
- Click Verify a Single Sender
- Fill in:
- Your name
- Your email (like noreply@yoursite.com)
- Company info
- Check your email and click the verification link
- Done! ✓
Option 2: Domain (Production)
- Settings → Sender Authentication
- Authenticate Your Domain
- Enter your domain
- Add DNS records (SendGrid shows you what to add)
- Click Verify
Create API Key
- Go to Settings → API Keys
- Click Create API Key
- Name it (like "My App")
- Choose Full Access (or Mail Send if you only send emails)
- Click Create & View
- Copy it immediately! (Can't see it again)
Warning
**Save now - **The API key is shown only once. Store it safely.
Step 2: Tell the Agent What You Want
Describe the emails you need:
Example 1: Basic Transactional Emails
I need SendGrid for sending emails.
SendGrid API key: [paste your key]
Send from: noreply@mysite.com
Emails I need:
- Welcome email when users sign up
- Password reset emails
- Order confirmations
Make them professional and clean.
Please set this up.
Example 2: Beautiful Email Templates
I need SendGrid with nice-looking email templates.
SendGrid API key: [paste your key]
Send from: hello@mycompany.com
Templates needed:
1. Welcome email (with user's name and "Get Started" button)
2. Order confirmation (with order details)
3. Monthly newsletter template
Make them:
- Mobile-friendly
- On-brand (blue #3B82F6)
- Professional
Please build this.
Example 3: E-commerce Emails
I need complete e-commerce email flow.
SendGrid API key: [paste your key]
Emails:
- Order placed (with order summary)
- Payment received (with receipt)
- Shipping update (with tracking link)
- Delivered confirmation
All should include:
- Customer name
- Order number
- Items purchased
- Totals
Please set this up.
Tip
**That's it - **The agent handles all the technical setup.
Step 3: Test Your Emails
After setup:
Click Preview
In Emergent, click Preview
Trigger Email
Do something that sends email (like sign up)
Check Inbox
Look for the email
Test on Mobile
Forward to your phone and check
Click All Links
Make sure buttons work
Check SendGrid Dashboard
View email in SendGrid Activity Feed
Common Questions
</Accordion> ## Something Not Working?Emails Not Sending
Tell the agent:
Emails aren't sending. Error message:
[paste error]
Can you fix the SendGrid integration?
Wrong Sender Address
Tell the agent:
Emails showing wrong sender.
Should be: support@mycompany.com
Can you update it?
Hitting Daily Limit
Tell the agent:
I'm hitting the 100 emails/day limit.
Can you add logic to:
1. Queue emails if limit reached
2. Warn me when close to limit
Real Examples
Example 1: SaaS Application
I need SendGrid for my SaaS app:
Welcome series:
- Day 1: Welcome + onboarding
- Day 3: Feature highlights
- Day 7: Check-in
Transactional:
- Password resets
- Billing receipts
- Usage alerts
SendGrid API key: [paste key]
From: hello@mysaas.com
Please build this.
Example 2: Marketplace
E-commerce marketplace emails:
For Buyers:
- Order confirmation
- Shipping updates
- Delivery confirmation
- Review request
For Sellers:
- New order alert
- Payout notifications
SendGrid API key: [paste key]
Please set all these up.
Advanced Features
Once basic emails work, you can ask for:
Email Templates
Create email templates in SendGrid dashboard that I can reuse.
Show me how to use them.
Scheduled Emails
I want to schedule emails:
- Send welcome email 1 hour after signup
- Send reminder 24 hours later
Email Lists
I need to send newsletters to my user list.
Set up email list management.
Quick Checklist
Before going live:
- Sender email/domain verified
- Tested all email types
- Emails not going to spam
- Mobile-friendly design
- All links work correctly
- Unsubscribe link included (required!)
- Checked SendGrid Activity Feed
Remember
Free tier is generous - 100 emails/day
Verify your domain for production - Better deliverability
Test thoroughly - Check spam folder too
Track your emails - Use SendGrid analytics
Add unsubscribe links - Required by law
Info
Stuck? Tell the agent: "I need help with SendGrid" and explain what's not working.
