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

# Move from Mailchimp or Brevo

> Export your contacts from Mailchimp or Brevo, import them into a Notifuse list, restore unsubscribes and bounces, and rebuild your templates.

You end with your contacts on a Notifuse list, your unsubscribed and bounced addresses marked as such, and your templates rebuilt with Liquid.

## Before you start

- A Notifuse workspace with an email provider connected.
- Access to your Mailchimp or Brevo account, to export contacts and templates.
- An account or API key with **Contacts write** and **Lists write**.
- A spreadsheet tool to split a CSV file by status.

## Migrate your audience

### 1. Export your contacts

Export your audience as CSV from Mailchimp, or your contacts as CSV from Brevo.

Keep each contact's status. Either export each status as its own file, or keep the status column so you can split the file yourself. You need three groups at the end:

- Subscribed contacts.
- Unsubscribed contacts.
- Bounced addresses and spam complaints (Mailchimp calls bounced addresses "cleaned").

The Notifuse import has no status column, so the split decides what each contact ends up as.

### 2. Create the list

In the Contacts rail, click **New list**. Give it a **Name** and check the **ID**: it can't be changed later, and the API and forms use it.

Imported contacts land on the list as active, even on a double opt-in list. They don't get a confirmation email.

### 3. Pause any automation that welcomes new subscribers

> [!WARNING]
>
> A CSV import adds each contact to the list as a new subscription, which fires `list.subscribed`. A live automation triggered on **Subscribed** for that list would enroll every imported contact and send each of them your welcome email.

In **Automations**, open each automation triggered by the list and click **Pause**, then **Yes, pause**. A paused automation enrolls nobody, and it doesn't catch up on the contacts imported in the meantime when you activate it again.

If you haven't built your automations in Notifuse yet, build them after the import.

### 4. Import the CSV

Go to **Contacts** → **All contacts** and click **Import**, or open the list and click **Import to list**. The drawer has three steps: **File**, **Columns** and **Import**.

1. **File**: drop the CSV. The first row must hold the column names, and one column must hold the email addresses.
2. **Columns**: a column named exactly like a field (`email`, `Email`, `first_name`, `First Name`…, in any case) is mapped for you. Map the others in **Imports into**, and leave the ones you don't need on **Don't import**. A Mailchimp column called "Email Address", for example, has to be mapped to **Email** by hand.
3. Under **Add to lists**, pick your new list.
4. Click the import button. It shows the number of rows, as in **Import 1,250 contacts**.

![The Columns step of Import contacts: each CSV column mapped to a contact field, and a list picked in Add to lists](https://www.notifuse.com/docs/assets/screenshots/import_csv.png)

Import every contact you want to keep, the unsubscribed ones included. Their status gets fixed in the next steps.

The import runs from your browser in batches of 100 rows. Keep the tab open. If it stops, drop the same file again to resume where it ended.

Fields that have no standard Notifuse field, such as a company or a plan, can go into custom fields. Set their names in the **More actions** menu → **Manage custom fields**.

### 5. Mark your unsubscribed contacts

In **Contacts**, open the **More actions** menu and choose **Bulk update (CSV)**. The **Bulk update from CSV** drawer opens.

1. Under **Action**, pick **Unsubscribe from a list**, then your list.
2. Drop the CSV of unsubscribed contacts and check the **Email column**.
3. Click the button that shows the count, such as **Unsubscribe 312 contacts**.

Notifuse never overwrites an unsubscribed, bounced or complained status during an import. Importing the same file again later won't subscribe these contacts back.

### 6. Mark bounced and complained addresses

The console can't set these two statuses. Use `POST /api/contactLists.updateStatus`, one contact per call, on contacts that are already on the list. The key needs **Lists write** and **Contacts write**.

```bash
curl -X POST https://YOUR_HOST/api/contactLists.updateStatus \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "YOUR_WORKSPACE_ID",
    "email": "old-address@example.com",
    "list_id": "newsletter",
    "status": "bounced"
  }'
```

Use `"status": "complained"` for spam complaints. Loop over your file and send one call per address.

If you would rather not keep these addresses at all, leave them out of the import instead.

### 7. Rebuild your templates

Go to **Templates** and click **New template**. Pick the **Editor mode**: **Visual** or **Code (MJML)**. It can't be changed after the template is created.

The **Import / Export** menu imports JSON or MJML only. Notifuse has no HTML import, so a template exported as HTML from Mailchimp or Brevo has to be rebuilt, or pasted into a raw HTML block of the visual editor.

Rewrite the merge tags as Liquid:

- First name: Mailchimp's `*|FNAME|*` or Brevo's `{{ contact.FIRSTNAME }}` becomes `{{ contact.first_name }}`.
- Last name: `*|LNAME|*` or `{{ contact.LASTNAME }}` becomes `{{ contact.last_name }}`.
- The unsubscribe link becomes `{{ unsubscribe_url }}`.

Check your own templates for other tags. Every contact field is available under `contact`, and custom fields under their key, such as `{{ contact.custom_string_1 }}`.

![The Import / Export menu of the template editor: import JSON or MJML, export HTML, MJML or JSON](https://www.notifuse.com/docs/assets/screenshots/template_import_export.png)

### 8. Turn your automations back on

Open each automation you paused and click **Activate**, then **Yes, activate**. From now on only new subscribers enter it.

## Check that it works

- The list shows the number of contacts you imported.
- Open a contact you know was unsubscribed in your old tool. Its status on the list is unsubscribed.
- The paused automations show no new journeys for the imported contacts.
- Send a test of each rebuilt template to yourself and check that the names and the unsubscribe link come out right.

## Next steps

> [card] [Warm up a new domain](https://www.notifuse.com/docs/deliverability/warm-up.md)
>
> Raise your volume gradually if you send from a new domain or provider.

> [card] [Build a welcome sequence](https://www.notifuse.com/docs/guides/welcome-sequence.md)
>
> Greet the subscribers who join from now on.

> [card] [Templates](https://www.notifuse.com/docs/features/templates.md)
>
> The visual editor, MJML and Liquid in detail.
