> ## Documentation Index
> Fetch the complete documentation index at: https://docs.migma.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Mailchimp Integration

> Connect Mailchimp and export reviewed Migma emails as templates or draft campaigns.

Use Mailchimp when your team wants Migma to prepare the email, then Mailchimp should own the final audience, journey, schedule, or send.

## What you can do

<CardGroup cols={2}>
  <Card title="Connect with OAuth" icon="key">
    Authorize Mailchimp from brand integrations. No new API key copy-paste is required for new connections.
  </Card>

  <Card title="Export templates" icon="document-plus">
    Save reviewed Migma emails into Mailchimp templates.
  </Card>

  <Card title="Create draft campaigns" icon="paper-plane">
    Prepare a Mailchimp campaign draft when the export flow supports campaign handoff.
  </Card>

  <Card title="Preserve merge tags" icon="tag">
    Keep Mailchimp merge tags such as `*|FNAME|*` in exported HTML.
  </Card>
</CardGroup>

## Connect Mailchimp

<Steps>
  <Step title="Open brand integrations">
    Open the brand, then go to **Integrations** and find **Mailchimp** under export destinations.
  </Step>

  <Step title="Click Connect">
    Sign in to Mailchimp and approve access for the account this brand should use.
  </Step>

  <Step title="Confirm the connected account">
    Migma shows the connected Mailchimp account before export so you can verify the destination.
  </Step>
</Steps>

<Note>
  Legacy API-key connections created before OAuth rollout continue to work until they are disconnected. New setup should use OAuth.
</Note>

## Export to Mailchimp

<Steps>
  <Step title="Review the email in Migma">
    Check copy, links, rendering, mobile behavior, and preflight.
  </Step>

  <Step title="Open Publish">
    Choose **Mailchimp** from export destinations.
  </Step>

  <Step title="Choose the handoff">
    Export a template or campaign draft, depending on the available action in Publish.
  </Step>

  <Step title="Finish in Mailchimp">
    Review the result, confirm audience and automation settings, then send from Mailchimp.
  </Step>
</Steps>

## Merge tags

Migma preserves Mailchimp merge tags that you include in your prompt or edit into the email.

```text theme={null}
Create a welcome email that starts with "Hi *|FNAME:there|*".
Include the Mailchimp unsubscribe link token *|UNSUB|* in the footer.
```

Common Mailchimp tokens:

| Token | Meaning         |      |                        |
| ----- | --------------- | ---- | ---------------------- |
| \`\*  | FNAME           | \*\` | First name             |
| \`\*  | LNAME           | \*\` | Last name              |
| \`\*  | EMAIL           | \*\` | Email address          |
| \`\*  | UNSUB           | \*\` | Unsubscribe link       |
| \`\*  | UPDATE\_PROFILE | \*\` | Preference update link |

<Warning>
  Mailchimp handles final merge-tag validation. Preview with Mailchimp audience data before sending.
</Warning>

## Import contacts from Mailchimp

Bring an existing Mailchimp audience into Migma without exporting a CSV. Imports read from your connected Mailchimp account and run in the background.

<Steps>
  <Step title="Start from Contacts">
    In **Audience**, click **Add Contact** then **Import from integration** and choose **Mailchimp**. If Mailchimp is not connected yet, connect it from the same screen.
  </Step>

  <Step title="Choose a source">
    Pick the audience, saved segment, or tag you want to import.
  </Step>

  <Step title="Confirm consent behavior">
    By default Migma imports subscribed contacts only. You can optionally include non-subscribed and unsubscribed contacts for record keeping, and those contacts stay non-sendable in Migma.
  </Step>

  <Step title="Start the import">
    The import runs as a background job. Watch progress in the dialog, or check **Import History** for the final counts.
  </Step>
</Steps>

Every import creates a source tag named after the audience, such as `Main Audience`, and a snapshot segment that targets it, so the imported audience is immediately usable. Importing the same source again reuses the same tag and segment, and each import still gets its own **Import History** record showing the provider, account, source, consent mode, and how many contacts were imported, updated, kept non-sendable, skipped, or failed.

<Note>
  Imports are one-time snapshots. Migma copies the selected source at import time and does not keep syncing it. Run another import when you want fresh data. Existing Migma contacts that unsubscribed or bounced are never resubscribed by an import.
</Note>

If the connected account cannot read contacts, the Mailchimp row offers **Reconnect**. After reconnecting, Migma returns you to the same import flow. CSV or paste import remains available as a fallback.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Mailchimp is not connected">
    Reconnect from brand integrations, then return to Publish and refresh the export destination.
  </Accordion>

  <Accordion title="Merge tags show as raw text">
    Confirm the syntax matches Mailchimp merge tags and test with a Mailchimp contact that has the field populated.
  </Accordion>

  <Accordion title="Export fails">
    Check that the connected Mailchimp account is active and that the audience or destination still exists.
  </Accordion>
</AccordionGroup>

## Related docs

<CardGroup cols={2}>
  <Card title="Export Options" icon="download" href="/email-editor/export-options">
    Compare Mailchimp export with other destinations.
  </Card>

  <Card title="Migma vs Mailchimp" icon="scale-balanced" href="/comparisons/migma-vs-mailchimp">
    Compare Migma and Mailchimp workflows.
  </Card>
</CardGroup>