Migrating from SendGrid to MailSend
This guide outlines how to migrate your contacts, templates, domains, credentials, and webhooks from SendGrid to MailSend smoothly.
Quick Answer
Migrating from SendGrid to MailSend involves exporting list databases and suppressions, updating DNS verification keys (SPF, DKIM, DMARC), and replacing API endpoints or REST API credentials. Most teams complete cutovers in under 2 hours.
1. What to Export
Download your contact list databases as CSV files from the SendGrid marketing console. Export active email layouts by copying their raw HTML source from the design console, and retrieve active suppression lists.
2. API & API Credentials
Replace SendGrid's API settings with MailSend's host `api.mailsend.dev` (port 587 with TLS). For REST API integrations, swap authorization header keys to match MailSend's Bearer tokens.
3. Verification & Testing
Deliver a test broadcast campaign to a small group of verified test addresses. Verify open and click metrics report accurately in the campaign panel.
Cutover Checklist
- 1Verify custom domain settings in MailSend settings
- 2Configure SPF, DKIM, and DMARC DNS settings
- 3Export subscriber records and suppression logs from legacy provider
- 4Import contacts CSV database using visual mapper
- 5Replace legacy API keys and API host settings in application server configs
- 6Verify webhook event routes are active and tested
- 7Monitor live delivery metrics in analytics panels