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.

CarefulImporting contacts requires `permission_confirmed: true` — your explicit confirmation that everyone on the list gave you permission to email them. Purchased, rented, scraped and appended lists aren't allowed, and the request is refused without the confirmation. We record it against the import.

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.suppressions({ file: sendgridExport, format: "csv" });

// permission_confirmed is required — the import is refused without it.
await mail.imports.contacts({
  file: csvBuffer,
  format: "csv",
  permission_confirmed: true,
});

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