New guide: how to warm up a dedicated IP without hurting your reputation. Read now →
Log in
MigoSMTP
Migration guide

Switch from SendGrid to MigoSMTP

Move your sending without losing reputation, history or sleep. Run both providers in parallel, then cut over in stages.

An AI assistant maps your SendGrid templates and webhooks for you to review

SendGrid audit
Authenticated domains
API keys and scopes
Dynamic templates
Event webhook
Suppression lists
Nothing missed
Plan first
Inventory what you useList the domains, API keys, dynamic templates, webhooks and suppressions on SendGrid so nothing is forgotten.
SENDGRID
MIGOSMTP
Domains
Domains
API keys
API keys
Templates
Templates
Webhooks
Webhooks
Cutover
1-to-1
Guided
Map each item acrossDomains, keys, templates and webhooks have direct equivalents. You recreate, not redesign.
AI maps it for you
Dynamic template
Template + variables
Event webhook
Signed webhook
Suppression list
Suppression import
Sender identity
Verified domain
Review and apply · nothing changes until you approve
Reads your setup
You approve
AI maps your templates and webhooksThe assistant reads your SendGrid templates and event settings and proposes the matching MigoSMTP setup. You review each mapping before it is applied.
Event webhook
Signed events
/events
200 OK
Analytics
200 OK
CRM
200 OK
Mapped events
Signed
Re-point the event webhookEvent names map across and payloads are signed, so your consumers need minimal change.
Add records
TYPE
NAME
VALUE
CNAME
mig._domainkey
dkim.migosmtp.com
TXT
@
v=spf1 include:sendgrid.net ~all
TXT
_dmarc
v=DMARC1; p=none
Both providers authorised
Side by side
No downtime
Authenticate your domainPublish DKIM and SPF for MigoSMTP alongside the old records so both can send during the move.
Share moved
Fully moved
D1
D3
D5
D7
D10
D14
D21
Staged cutover
Monitored
Shift traffic graduallyMove a little more volume each day, so reputation carries across with no sudden jump.
Audit
Map
AI migrator
Events
Authenticate
Warm
Before you start
  • Admin access to your SendGrid account
  • Access to DNS for your sending domains
  • An export of suppressions and templates
  • A list of services that send email
The plan

A migration in five steps

1

Audit

List your domains, keys, templates, webhooks and suppressions.

2

Authenticate

Add MigoSMTP DNS records alongside the old ones.

3

Rebuild

Recreate templates and webhooks, import suppressions.

4

Cut over

Shift traffic in stages and watch delivery.

5

Retire

Remove old records and keys once stable.

Concepts

How your setup maps across

SendGridMigoSMTPWhat to do
Sender AuthenticationDomain authenticationAdd the new records and verify them.
API keysScoped API keysCreate new keys with the minimum scopes.
Dynamic TemplatesTemplatesRecreate content and variables.
Event WebhookWebhooks and eventsPoint endpoints at the new payload format.
Suppressions and groupsSuppression list and unsubscribe groupsImport before sending.
SubusersWorkspacesOne workspace per subuser.

Terminology reflects the provider's documentation at the time of writing. Verify against current docs before publishing.

How a message travels

From your app to the inbox, with checks at every hop

Your appSends by SMTP or API with your key.
IntakeAuthenticates, validates and rate-checks the request.
Queue and routingPrioritises mail and picks the right IP pool.
Signing and deliverySigns with DKIM and delivers with provider-aware pacing.
Inbox and eventsDelivery, bounce and engagement events flow back to you.
Code changes

Update your send call

Before
curl https://api.sendgrid.com/v3/mail/send \
  -H "Authorization: Bearer SENDGRID_KEY" \
  -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>Hi there</p>" }] }'
After
curl https://api.migosmtp.com/v1/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@yourdomain.com",
    "to": "user@example.com",
    "subject": "Hello",
    "html": "<p>Hi there</p>"
  }'

Illustrative requests. See the API reference for the complete field list.

Overview

How do I migrate from SendGrid to MigoSMTP?

Use cases

Ways to move from SendGrid

Move transactional mail first

Start with receipts, password resets and alerts sent through the v3 mail send API. Volume is predictable, so you can compare delivery against SendGrid before moving anything else.

Run both in parallel

Keep SendGrid live while a small percentage of mail goes through MigoSMTP. Split by application, template or recipient domain, and widen the share once bounce and complaint rates match.

Split subusers into workspaces

If you use subusers per customer or brand, create one MigoSMTP workspace for each. Reputation, keys and suppression data stay separated the way they are today.

Replace the event webhook

Point your delivery, bounce, open and click handlers at MigoSMTP webhooks. Run a mapping layer briefly so downstream systems that expect the old event names keep working.

AI features

AI-assisted migration from SendGrid

Templates

Template converter

Reads each dynamic template, converts handlebars variables and conditional blocks, and shows a side-by-side preview. You review the output and approve each template before it is saved.

Webhooks

Webhook mapping

Compares your SendGrid event webhook settings with MigoSMTP events and proposes a field-by-field mapping with confidence scores. Nothing is applied until a team member signs off on it.

Monitoring

Cutover anomaly watch

During staged cutover it watches bounce, deferral and complaint trends against your baseline and raises an alert if they drift. You decide whether to pause, hold or continue the ramp.

Warm-up

Adaptive warm-up plan

If you move to dedicated IPs, it drafts a ramp from your volume history and adjusts the plan as results arrive. You approve each step before the sending schedule changes.

AI suggestions for your SendGrid migration are reviewed and approved by you before anything is applied. [Confirm which AI features are available at launch.]

Best practices

Migration best practices

Export suppressions before anything else

Download bounces, spam reports, unsubscribes and group suppressions first. Importing them before the first send protects recipients who already opted out and keeps complaint rates low.

Keep the old DNS records in place

Add MigoSMTP DKIM and return-path records beside the SendGrid ones. Both can authenticate your domain at the same time, so you can roll back quickly.

Test templates with real data

Send each converted template with production-like variables, including empty and missing values. Differences in how conditionals are evaluated are the most common source of broken emails.

Move one stream at a time

Cut over transactional mail, then marketing mail, as separate steps. Different volumes and engagement patterns mean each stream deserves its own check before the next begins.

Rotate keys after cutover

Once all services use MigoSMTP keys, revoke the SendGrid API keys. Do this last, after logs show no remaining traffic using them.

FAQs

SendGrid: frequently asked questions

How do I migrate from SendGrid to MigoSMTP?

Audit your SendGrid setup, add MigoSMTP domain authentication records alongside the existing ones, recreate templates and webhooks, import suppressions, then shift traffic in stages. Retire SendGrid only after volume is stable. Most teams run both providers in parallel during the transition.

How long does it take to migrate from SendGrid?

It depends on how many templates, webhooks and sending applications you have. A single application with a few templates can move in days; a multi-subuser setup takes longer. Plan [n] weeks for staged cutover and warm-up if you add dedicated IPs.

Can I keep my SendGrid dynamic templates?

You rebuild them in MigoSMTP, but you do not start from nothing. Export the template HTML and variables, and the converter proposes a matching version for you to review. Check handlebars helpers and conditionals in preview before approving. Test on a small share of traffic first and review the results with your team.

Will I lose my sender reputation?

Reputation belongs to your domain and sending IPs, so it does not transfer automatically. Authenticate your domain, send a small share first, and increase gradually. On shared infrastructure you start with the pool's reputation; dedicated IPs need warm-up. Test on a small share of traffic first and review the results with your team.

What happens to my SendGrid suppression list?

Export it and import it into MigoSMTP before your first send, so bounced and unsubscribed addresses are not mailed again. Include unsubscribe group data if you use groups. Check the export format against [verify against provider docs]. Test on a small share of traffic first and review the results with your team.

Do I need to change my code to leave SendGrid?

If you send over SMTP, usually only the host, port and credentials change. If you use the v3 mail send API, the request body differs, so update the call or use an SDK. Test in a staging environment first. Test on a small share of traffic first and review the results with your team.

Can I run SendGrid and MigoSMTP at the same time?

Yes. Both can authenticate the same domain at once, so you can route a percentage of mail through MigoSMTP and keep SendGrid for the rest. Split by application or template to make comparison easy. Keep SendGrid credentials active until logs show no remaining use.

Can AI migrate my SendGrid setup automatically?

AI does the tedious mapping, not the decisions. It reads your exported configuration, proposes template, webhook and subuser mappings with confidence scores, and flags gaps. Nothing is applied until a person on your team approves each change. [Confirm which AI features are available at launch.]

Can I run both providers at once?

Yes. Most teams send a small share through MigoSMTP first and increase gradually.

Do I need to warm up?

Moving from a shared pool to a dedicated IP needs warmup. Use the guide or the calculator.

Will you help with the move?

Our team can review your plan for SendGrid and the cutover schedule.

Start sending in minutes.

Create an account, add your domain and send your first email.