Audience

Imports & migration

Bring contacts and your do-not-email list over — no reputation lost.

Move in from another provider in one step. Import contacts and, crucially, your suppression list so you never email someone who already opted out.

POST/v1/imports/contactsImport contacts (CSV/JSON or a provider export).

POST/v1/imports/suppressionsImport a suppression/unsubscribe list.

From SendGrid, Postmark, or Mailgun

Export your contacts and suppressions from your current provider, then import both. Your history and reputation come with you.

migrate.ts

await mail.imports.contacts({ file: csvBuffer, format: "csv" });
await mail.imports.suppressions({ file: sendgridExport, format: "csv" });

tipDo the suppression import first, then contacts — that way a re-imported contact who previously unsubscribed stays suppressed.