SendGrid

About SendGrid

SendGrid (by Twilio) is a cloud-based email platform handling both transactional and marketing emails. It’s known for high deliverability and extensive features.

Website: sendgrid.com

Prerequisites

1. A SendGrid account
2. A verified sender identity
3. An API key with Mail Send permissions

Getting Your API Key

1. Log in to SendGrid
2. Go to Settings > API Keys
3. Click Create API Key
4. Choose Restricted Access
5. Under Mail Send, enable Full Access
6. Click Create & View
7. Copy the key (starts with SG.)

Configuration

Add SendGrid in mailshit:

1. Go to Settings > Providers
2. Click Add Provider
3. Select SendGrid
4. Enter the following:

5. Click Save

Sender Verification

SendGrid requires sender verification:

Single Sender Verification

For testing or low volume:

1. Go to Settings > Sender Authentication
2. Click Verify a Single Sender
3. Enter sender details
4. Click the verification link in your email

Domain Authentication

For production (recommended):

1. Go to Settings > Sender Authentication
2. Click Authenticate Your Domain
3. Add the DNS records SendGrid provides
4. Wait for verification

Free Tier

SendGrid’s free tier includes:

• 100 emails/day forever
• No credit card required
• Basic analytics

API Key Permissions

For mailshit, your API key needs:

• Mail Send - Full Access
• Other permissions are optional

Restricted permissions improve security.

Example Response

{
  "success": true,
  "type": "sent",
  "messageId": "sg_abc123xyz..."
}

Best Practices

1. Use domain authentication for better deliverability
2. Create dedicated API keys for each application
3. Monitor suppressions in SendGrid’s Activity Feed
4. Set up event webhooks to track bounces and complaints

Troubleshooting

“The from address does not match a verified Sender Identity”

• Complete sender verification in SendGrid
• Use a verified email address

“Forbidden” (403 error)

• Check API key has Mail Send permissions
• Regenerate the key if needed

Emails going to spam

• Complete domain authentication
• Check your sender reputation in SendGrid
• Review email content for spam triggers