> ## Documentation Index > Fetch the complete documentation index at: https://docs.autosend.com/llms.txt > Use this file to discover all available pages before exploring further. # Migrate from Resend to AutoSend > Use the Resend Migration API to move templates, contacts, audiences, custom fields, topics, and unsubscribes from Resend into AutoSend. export const AUTOSEND_PATHS = { dashboard: 'https://autosend.com/dashboard', apiKey: 'https://autosend.com/account/api-key', faqs: 'https://autosend.com/faq', marketingEmails: 'https://autosend.com/marketing-emails', webhooks: 'https://autosend.com/webhooks', composeByAutoSend: 'https://autosend.com/compose', emailActivity: 'https://autosend.com/email-activities', team: 'https://autosend.com/settings/team', pricing: 'https://autosend.com/pricing', verifyEmail: 'https://autosend.com/compose/email-builder?template=verify-email', welcomeEmail: 'https://autosend.com/compose/email-builder?template=welcome-email', productUpdate: 'https://autosend.com/compose/email-builder?template=product-update', newsletter: 'https://autosend.com/compose/email-builder?template=newsletter', automations: 'https://autosend.com/automations', globalSuppressions: 'https://autosend.com/suppressions/global', signup: 'https://autosend.com/signup', domains: 'https://autosend.com/settings/domains', smtpKey: 'https://autosend.com/settings/smtp', logoKit: 'https://asend.email/logo', contactsPage: 'https://autosend.com/contacts/list-and-segments', accountBilling: 'https://autosend.com/account/billing', accountUsage: 'https://autosend.com/account/usage', terms: 'https://autosend.com/legal/terms', inbound: 'https://autosend.com/email-activities/inbound' }; export const APP_PATHS = { home: '/', quickstart: '/quickstart', domainConfiguration: '/domain', apiReference: '/api-reference', sendEmail: '/api-reference/mails/send', bulkSendEmail: '/api-reference/mails/bulk', upsertContactApiRef: '/api-reference/contacts/upsert-contact', transactional: '/transactional-emails', emailActivity: '/transactional-emails/email-activity', emailTemplates: '/transactional-emails/email-templates', sendingEmail: '/quickstart/email-using-api', transactionalTroubleshooting: '/transactional-emails/troubleshooting', marketing: '/marketing-emails', campaigns: '/marketing-emails/campaigns', contacts: '/marketing-emails/contacts', contactsIntroduction: '/marketing-emails/contacts/introduction', contactsImportCsv: '/marketing-emails/contacts/import-csv', contactsLists: '/marketing-emails/contacts/lists', contactsSegments: '/marketing-emails/contacts/segments', contactsCustomFields: '/marketing-emails/contacts/contact-properties', contactsContactProperties: '/marketing-emails/contacts/contact-properties', createContactPropertyApiRef: '/api-reference/contact-properties/create', listContactPropertiesApiRef: '/api-reference/contact-properties/list', getContactPropertyApiRef: '/api-reference/contact-properties/get-by-name', deleteContactPropertyApiRef: '/api-reference/contact-properties/delete', sender: '/marketing-emails/sender', unsubscribeGroups: '/others/unsubscribe-groups', webhookIntroduction: '/others/webhooks/introduction', webhookEventType: '/others/webhooks/event-type', webhookRetries: '/others/webhooks/retries', webhookVerifyRequests: '/others/webhooks/verify-requests', dynamicTemplates: '/dynamic-templates', guides: '/guides', sitemap: '/sitemap.xml', team: '/others/team', automations: '/automations', events: '/automations/events', sendEventApi: '/api-reference/events/send-event', smtpIntroduction: '/quickstart/smtp', betterAuth: '/guides/better-auth', convexGuide: '/guides/convex', templateVariables: '/transactional-emails/variables', suppressions: '/others/suppressions', rateLimit: '/api-reference/rate-limit', nodejsSdk: '/sdk/nodejs', smtpIntegrationGuides: '/guides/smtp', apiKeys: '/api-keys', encryptedPayloads: '/others/encrypted-payloads', apiReferenceIntroduction: '/api-reference/introduction', lovableGuide: '/ai/integrations/lovable', aiIntroduction: '/ai/introduction', aiSkills: '/ai/skills', aiMcpServer: '/ai/mcp-server', aiLovable: '/ai/integrations/lovable', aiBolt: '/ai/integrations/bolt', aiV0: '/ai/integrations/v0', aiReplit: '/ai/integrations/replit', mcpClaude: '/ai/mcp-clients/claude', mcpCursor: '/ai/mcp-clients/cursor', mcpCopilot: '/ai/mcp-clients/copilot', mcpWindsurf: '/ai/mcp-clients/windsurf', mcpCodex: '/ai/mcp-clients/codex', mcpAntigravity: '/ai/mcp-clients/antigravity', mcpChatgpt: '/ai/mcp-clients/chatgpt', mcpRaycast: '/ai/mcp-clients/raycast', domainWarmup: '/marketing-emails/domain-warmup', projects: '/projects', createAutomationApi: '/api-reference/automations/create-automation', migrationSendgrid: '/migration/sendgrid', migrationResend: '/migration/resend', auth0CustomAction: '/guides/auth0-custom-action', accountBilling: '/others/account/billing', accountUsage: '/others/account/usage', inboundIntroduction: '/inbound/introduction', listInboundMessagesApi: '/api-reference/inbound-emails/list-messages', getInboundMessageApi: '/api-reference/inbound-emails/get-message', downloadInboundAttachmentApi: '/api-reference/inbound-emails/download-attachment', replyToInboundMessageApi: '/api-reference/inbound-emails/reply-to-message', wikiDailySendingLimit: '/wiki/daily-sending-limit' }; ## Overview AutoSend provides a set of public API endpoints to migrate your Resend assets into your AutoSend project: * Templates * Contacts and audiences (contact lists) * Contact properties (custom fields) * Topics (suppression groups) * Unsubscribed contacts All endpoints are authenticated with your **AutoSend project API key** sent as a Bearer token. The Resend API key required to read from your Resend account is passed in the request body for each call. It is never persisted in plaintext - it is encrypted while the background job is queued. ## Prerequisites Before you start, make sure you have: 1. An **AutoSend project API key** - create one on the **API Keys** page. Keys look like `AS_xxxxxxxx_xxxxxxxxxxxxxxxxxxxx`. 2. A **Resend API key** - generate one in Resend under *API Keys*. The key needs read access to templates, contacts, audiences, contact properties, and topics. Keys look like `re_xxxxxxxxxxxxxxxxxxxxxxxx`. 3. The base URL for all requests: `https://api.autosend.com/v1` ### Authentication Every request uses two headers: | Header | Value | | --------------- | -------------------------------- | | `Authorization` | `Bearer ` | | `Content-Type` | `application/json` | ## How Resend Maps to AutoSend Resend and AutoSend model their assets a little differently. The migration applies these mappings: | Resend | AutoSend | Notes | | -------------------- | ------------------------ | ------------------------------------------------------------------------------------- | | Template | Template | HTML, subject, and name are migrated. Templates using `#each` are flagged for review. | | Contact property | Custom field | Type is mapped (`string`/`text` to string, `number`, `boolean`, `date`). | | Audience | Contact list | List metadata is created; members are associated in the contacts phase. | | Topic | Suppression group | Created as an **empty** group - Resend's API exposes no per-topic subscription state. | | Unsubscribed contact | Global suppression entry | Resend has no unsubscribe groups, so unsubscribed contacts are suppressed globally. | ## Recommended Flow Call `POST /migrations/resend/plan` to confirm the Resend key is valid and see what will be migrated. Call `POST /migrations/resend/migrate` with `migrateAll: true` or with specific IDs you want to import. Use `POST /migrations/resend/template` to migrate selected templates only. ## Endpoints ### Get migration plan Fetches a preview of everything that can be migrated from your Resend account: templates, contact properties (custom fields), audiences, topics, the total contact count, and the count of unsubscribed contacts. **`POST /v1/migrations/resend/plan`** #### Request body | Field | Type | Required | Description | | -------------- | ------ | -------- | ------------------- | | `resendApiKey` | string | yes | Your Resend API key | ```bash cURL theme={null} curl --request POST \ --url https://api.autosend.com/v1/migrations/resend/plan \ --header 'Authorization: Bearer AS_YOUR_AUTOSEND_KEY' \ --header 'Content-Type: application/json' \ --data '{ "resendApiKey": "re_your_resend_api_key" }' ``` ```javascript NodeJS theme={null} const res = await fetch("https://api.autosend.com/v1/migrations/resend/plan", { method: "POST", headers: { Authorization: `Bearer ${process.env.AUTOSEND_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ resendApiKey: process.env.RESEND_API_KEY, }), }); const data = await res.json(); ``` ```python Python theme={null} import os import requests res = requests.post( "https://api.autosend.com/v1/migrations/resend/plan", headers={ "Authorization": f"Bearer {os.environ['AUTOSEND_API_KEY']}", "Content-Type": "application/json", }, json={"resendApiKey": os.environ["RESEND_API_KEY"]}, ) data = res.json() ``` #### Response `200` ```json expandable theme={null} { "success": true, "message": "Migration plan fetched successfully", "data": { "contactsCount": 12453, "unsubscribedCount": 87, "templatesCount": 24, "templates": [ { "templateId": "tmpl_abc123", "templateName": "Welcome email", "status": "active", "updatedAt": "2025-08-12T10:24:11Z" } ], "customFields": [ { "resendFieldId": "1", "resendFieldName": "company", "autosendFieldName": "company", "fieldType": "string" } ], "audiences": [ { "id": "aud-uuid-1", "name": "Newsletter subscribers" } ], "audiencesCount": 5, "topics": [ { "id": "topic-uuid-1", "name": "Product updates", "description": "Monthly product newsletter", "defaultSubscription": "opt_in", "visibility": "public" } ], "topicsCount": 3 } } ``` ### Run the full migration Kicks off a background migration job that imports the selected Resend assets into your AutoSend project. Returns a `bulkOperationId` immediately; the work continues in the background. **`POST /v1/migrations/resend/migrate`** #### Request body | Field | Type | Required | Default | Description | | --------------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------- | | `resendApiKey` | string | yes | - | Your Resend API key | | `migrateAll` | boolean | no | `false` | If `true`, migrate everything returned by `/plan`. Per-type ID arrays below are populated from the plan when empty. | | `templateIds` | string\[] | no | `[]` | Specific Resend template IDs to migrate | | `audienceIds` | string\[] | no | `[]` | Specific Resend audience IDs to migrate (each becomes an AutoSend contact list) | | `topicIds` | string\[] | no | `[]` | Specific Resend topic IDs to migrate (each becomes an AutoSend suppression group) | | `customFieldMappings` | object\[] | no | `[]` | Resend to AutoSend custom field mappings (see schema below) | | `ignoreTemplates` | boolean | no | `false` | Skip templates phase | | `ignoreCustomFields` | boolean | no | `false` | Skip custom fields phase | | `ignoreAudiences` | boolean | no | `false` | Skip audiences (contact lists) phase | | `ignoreTopics` | boolean | no | `false` | Skip topics (suppression groups) phase | | `ignoreContacts` | boolean | no | `false` | Skip contacts phase | | `ignoreSuppressions` | boolean | no | `false` | Skip the global unsubscribe (suppression) phase | `customFieldMappings` item schema: ```json theme={null} { "resendFieldId": "1", "resendFieldName": "company", "autosendFieldName": "company", "fieldType": "string" } ``` `fieldType` must be one of: `string`, `number`, `boolean`, `date`. #### Migration phases The job runs in this order: 1. **Custom fields** - creates AutoSend custom field definitions from the mappings. 2. **Templates** - fetches each Resend template's HTML and subject and creates the matching AutoSend template. Templates containing `#each` are flagged for manual review. 3. **Audiences to contact lists** - creates the AutoSend list metadata for each audience. 4. **Contacts** - imports all global Resend contacts, then associates each audience's members with the contact list created in step 3. Contact properties are mapped onto custom fields via `customFieldMappings`. 5. **Topics to suppression groups** - creates a matching (empty) suppression group for each topic. 6. **Suppressions** - globally suppresses every Resend contact marked as `unsubscribed`. #### Example A - migrate everything ```bash cURL theme={null} curl --request POST \ --url https://api.autosend.com/v1/migrations/resend/migrate \ --header 'Authorization: Bearer AS_YOUR_AUTOSEND_KEY' \ --header 'Content-Type: application/json' \ --data '{ "resendApiKey": "re_your_resend_api_key", "migrateAll": true }' ``` ```javascript NodeJS theme={null} const res = await fetch("https://api.autosend.com/v1/migrations/resend/migrate", { method: "POST", headers: { Authorization: `Bearer ${process.env.AUTOSEND_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ resendApiKey: process.env.RESEND_API_KEY, migrateAll: true, }), }); const { data } = await res.json(); console.log(data.bulkOperationId); ``` ```python Python theme={null} import os import requests res = requests.post( "https://api.autosend.com/v1/migrations/resend/migrate", headers={ "Authorization": f"Bearer {os.environ['AUTOSEND_API_KEY']}", "Content-Type": "application/json", }, json={ "resendApiKey": os.environ["RESEND_API_KEY"], "migrateAll": True, }, ) print(res.json()["data"]["bulkOperationId"]) ``` #### Example B - migrate selected assets only ```bash theme={null} curl --request POST \ --url https://api.autosend.com/v1/migrations/resend/migrate \ --header 'Authorization: Bearer AS_YOUR_AUTOSEND_KEY' \ --header 'Content-Type: application/json' \ --data '{ "resendApiKey": "re_your_resend_api_key", "templateIds": ["tmpl_abc123", "tmpl_def456"], "audienceIds": ["aud-uuid-1"], "customFieldMappings": [ { "resendFieldId": "1", "resendFieldName": "company", "autosendFieldName": "company", "fieldType": "string" } ], "ignoreTopics": true }' ``` #### Example C - contacts only, skip everything else ```bash theme={null} curl --request POST \ --url https://api.autosend.com/v1/migrations/resend/migrate \ --header 'Authorization: Bearer AS_YOUR_AUTOSEND_KEY' \ --header 'Content-Type: application/json' \ --data '{ "resendApiKey": "re_your_resend_api_key", "migrateAll": true, "ignoreTemplates": true, "ignoreCustomFields": true, "ignoreAudiences": true, "ignoreTopics": true, "ignoreSuppressions": true }' ``` #### Response `202 Accepted` ```json theme={null} { "success": true, "message": "Resend migration initiated successfully", "data": { "bulkOperationId": "65fa1d2b8c9a4f1234567890", "status": "PENDING", "message": "Resend migration initiated successfully" } } ``` Hold on to the `bulkOperationId`. Your AutoSend dashboard shows progress against it, and progress is also published in real time over the project's Pusher channel as the job moves through each phase. #### Common errors | HTTP | Code | Meaning | | ---- | ---------------------------------- | ----------------------------------------------------------------------- | | 400 | `RESEND_MIGRATION_IN_PROGRESS` | A migration is already running for this project - wait for it to finish | | 400 | `RESEND_NO_ITEMS_TO_MIGRATE` | Nothing selected and `migrateAll` was not set | | 500 | `RESEND_FAILED_TO_FETCH_PLAN` | Resend API key is invalid or rejected | | 500 | `RESEND_MIGRATION_CREATION_FAILED` | Could not schedule the migration job - retry shortly | ### Migrate one or more templates Migrate specific Resend templates without touching anything else. Useful for one-off moves or for syncing a template after edits in Resend. Always test migrated templates that contain complex Handlebars expressions such as `#each` before sending production traffic to them. **`POST /v1/migrations/resend/template`** #### Request body | Field | Type | Required | Default | Description | | ------------------- | --------- | -------- | ------- | ----------------------------------------------------------------------------------------- | | `resendApiKey` | string | yes | - | Your Resend API key | | `resendTemplateIds` | string\[] | yes | - | Resend template IDs to migrate (min 1) | | `onExistUpdateHTML` | boolean | no | `false` | If a template with the same ID already exists in AutoSend, overwrite its HTML and subject | ```bash cURL theme={null} curl --request POST \ --url https://api.autosend.com/v1/migrations/resend/template \ --header 'Authorization: Bearer AS_YOUR_AUTOSEND_KEY' \ --header 'Content-Type: application/json' \ --data '{ "resendApiKey": "re_your_resend_api_key", "resendTemplateIds": ["tmpl_abc123", "tmpl_def456"], "onExistUpdateHTML": true }' ``` ```javascript NodeJS theme={null} const res = await fetch("https://api.autosend.com/v1/migrations/resend/template", { method: "POST", headers: { Authorization: `Bearer ${process.env.AUTOSEND_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ resendApiKey: process.env.RESEND_API_KEY, resendTemplateIds: ["tmpl_abc123", "tmpl_def456"], onExistUpdateHTML: true, }), }); ``` ```python Python theme={null} import os import requests res = requests.post( "https://api.autosend.com/v1/migrations/resend/template", headers={ "Authorization": f"Bearer {os.environ['AUTOSEND_API_KEY']}", "Content-Type": "application/json", }, json={ "resendApiKey": os.environ["RESEND_API_KEY"], "resendTemplateIds": ["tmpl_abc123", "tmpl_def456"], "onExistUpdateHTML": True, }, ) ``` #### Response `200` ```json theme={null} { "success": true, "message": "Template migrated successfully", "data": [ { "templateId": "tmpl_abc123", "templateName": "Welcome email", "subject": "Welcome to Acme", "templateType": "TRANSACTIONAL", "createdAt": "2026-05-14T08:12:11.234Z" } ] } ``` ## FAQ The key is held in memory for the lifetime of the migration request and encrypted at rest while the background job is queued. It is never logged or stored in plaintext. Resend's contact object exposes no per-topic subscription state, so the migration can create the group but cannot derive its members from the API. Globally unsubscribed contacts are still captured in the separate suppressions phase. Yes. Templates are upserted by their Resend `templateId` when `onExistUpdateHTML: true`. Contacts and suppressed emails are upserted by email address, so duplicates are safe. Re-creating an already-existing custom field will fail that one creation and be reported in the metrics, but the run continues. Only one migration can run per project at a time. Templates and topics are usually done in seconds. Contacts depend on how many you have. Resend's API is rate-limited to roughly 2 requests/second, and the migration spaces requests out and retries on `429` to stay within that limit, so large contact counts take proportionally longer. The request returns immediately - the job keeps running after your HTTP connection closes. During the contacts phase, each Resend contact's `properties` are matched against your `customFieldMappings` (by `resendFieldId`, falling back to `resendFieldName`) and written onto the AutoSend contact's custom fields. Include the mappings in `/migrate` (or use `migrateAll`) to populate them. ## Support If a migration fails or produces unexpected results, send us: 1. The `bulkOperationId` returned by `/migrate` 2. Your AutoSend project ID 3. The approximate time of the request Email [support@autosend.com](mailto:support@autosend.com) with these details and we'll investigate. ## Next Steps Manage the templates you just migrated from Resend. Browse and segment the contacts imported from Resend. Review the suppression groups created during migration. Verify your sending domain so migrated templates can start sending.