Migrate from SendGrid

Overview

Moving from SendGrid to Unosend simplifies your email infrastructure. No more complex template engines or Web API v3 quirks — just a clean REST API. Why switch:

Simpler API — clean JSON payloads vs SendGrid’s nested personalizations objects
Better pricing — up to 60% lower at scale
Unlimited broadcasts — no separate marketing email limits
Built-in SMS + WhatsApp — no need for separate Twilio services

Migration Steps

1. Create Your Unosend Account

Sign up at unosend.co/signup
Add and verify your sending domain
Generate an API key

2. Update Environment Variables

- SENDGRID_API_KEY=SG.xxxxxxxxxxxx
+ UNOSEND_API_KEY=un_xxxxxxxxxxxx

3. Update Your Code

Node.js
Python
cURL

Before (SendGrid):

const sgMail = require('@sendgrid/mail');
sgMail.setApiKey(process.env.SENDGRID_API_KEY);

await sgMail.send({
  to: 'user@example.com',
  from: 'hello@yourdomain.com',
  subject: 'Hello',
  html: '<p>Welcome!</p>'
});

After (Unosend):

import { Unosend } from 'unosend';
const unosend = new Unosend(process.env.UNOSEND_API_KEY);

await unosend.emails.send({
  from: 'hello@yourdomain.com',
  to: ['user@example.com'],
  subject: 'Hello',
  html: '<p>Welcome!</p>'
});

Before (SendGrid):

from sendgrid import SendGridAPIClient
from sendgrid.helpers.mail import Mail

sg = SendGridAPIClient(os.environ.get('SENDGRID_API_KEY'))
message = Mail(
    from_email='hello@yourdomain.com',
    to_emails='user@example.com',
    subject='Hello',
    html_content='<p>Welcome!</p>'
)
sg.send(message)

After (Unosend):

import unosend
client = unosend.Client(api_key=os.environ.get('UNOSEND_API_KEY'))

client.emails.send(
    from_email='hello@yourdomain.com',
    to=['user@example.com'],
    subject='Hello',
    html='<p>Welcome!</p>'
)

Before (SendGrid):

curl -X POST https://api.sendgrid.com/v3/mail/send \
  -H "Authorization: Bearer SG.xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "personalizations": [{"to": [{"email": "user@example.com"}]}],
    "from": {"email": "hello@yourdomain.com"},
    "subject": "Hello",
    "content": [{"type": "text/html", "value": "<p>Welcome!</p>"}]
  }'

After (Unosend):

curl -X POST https://www.unosend.co/api/v1/emails \
  -H "Authorization: Bearer un_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"from":"hello@yourdomain.com","to":["user@example.com"],"subject":"Hello","html":"<p>Welcome!</p>"}'

No more nested personalizations — just a flat JSON object.

4. Update DNS Records

Remove SendGrid’s DNS records and add Unosend’s:

Type	Name	Value
TXT	`unosend._domainkey`	Your DKIM public key
MX	`send`	`10 mail.unosend.co`
TXT	`send`	`v=spf1 include:_spf.unosend.co ~all`

5. Migrate Contacts

Export contacts from SendGrid (Marketing → Contacts → Export) as CSV, then import into Unosend:

Go to Audiences in the Unosend dashboard
Create an audience
Click Import Contacts
Upload your SendGrid CSV export

Key Differences

Feature	SendGrid	Unosend
Email payload	Nested `personalizations` array	Flat JSON object
`to` field	`[{"email": "..."}]`	`["email@..."]`
HTML content	`content: [{type, value}]`	`html: "..."`
Webhooks	Event Webhook	Native webhooks
Templates	Dynamic Templates (Handlebars)	Mustache variables
SMTP	Port 587	Ports 25, 465, 587, 2525

Pricing Comparison

Emails/Month	SendGrid	Unosend	Savings
40,000	$20/mo (Essentials)	$20/mo	Same
100,000	$45/mo	$50/mo	—
300,000	Custom	$165/mo	—
1,000,000	Custom	$600/mo	—

Unosend includes broadcasts, SMS, WhatsApp, and email validation at no extra cost.

Quick Start Guide

Get sending in under 5 minutes

Getting Started

Guides

Integrations

Migration

Tools

Resources

Migrate from SendGrid

Overview

Migration Steps

1. Create Your Unosend Account

2. Update Environment Variables

3. Update Your Code

4. Update DNS Records

5. Migrate Contacts

Key Differences

Pricing Comparison

Quick Start Guide

Getting Started

Guides

Integrations

Migration

Tools

Resources

​Overview

​Migration Steps

​1. Create Your Unosend Account

​2. Update Environment Variables

​3. Update Your Code

​4. Update DNS Records

​5. Migrate Contacts

​Key Differences

​Pricing Comparison

Quick Start Guide

Overview

Migration Steps

1. Create Your Unosend Account

2. Update Environment Variables

3. Update Your Code

4. Update DNS Records

5. Migrate Contacts

Key Differences

Pricing Comparison