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

# Importing Contacts

> Got a big list of people? Drop it in. We'll sort it all out for you.

# Importing Contacts 📋

Already have a bunch of contacts somewhere? Great — bring them in. Mailofly makes it easy to import a whole list at once, whether it's sitting in a spreadsheet on your computer or live in Google Sheets.

***

## Option 1: Upload a CSV file

Got your contacts in a `.csv` file? Perfect.

1. Head to **Contacts** in the sidebar
2. Click **Import** → **Upload CSV**
3. Pick your file
4. Map the columns — tell Mailofly which column is the email, which is the first name, etc.
   * `email` — **required**, can't skip this one
   * `first_name` — optional
   * `last_name` — optional
   * Any other columns get stored as custom **properties** automatically
5. Click **Start Import**

Imports up to **100,000 contacts** run in the background and finish within a few minutes. You'll get notified when it's done.

***

## Option 2: Google Sheets live sync

Have your contacts in a Google Sheet? You can connect it directly and keep it in sync — no manual exports needed.

1. In **Contacts**, click **Import** → **Google Sheets Sync**
2. Paste the URL of your Google Sheet (it needs to be shared or public)
3. Choose the tab and map the column headers to Mailofly fields
4. Click **Connect**

Mailofly will import the existing rows and automatically check for new rows on a schedule, so your audience stays up-to-date as you add people to the sheet.

***

## Tips for a smooth import

* 📧 Double-check your email column — invalid addresses will be skipped
* 🔤 UTF-8 encoding works best for CSV files
* ✅ Duplicate emails are handled automatically — existing contacts get updated, not duplicated


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.