Skip to main content
The import feature lets you bring large sets of contacts into the HoopAI Platform from a CSV file. You can import contacts and opportunities simultaneously, map custom fields, add imported contacts to workflows and smart lists, and control how duplicates are handled.

​
Preparing your CSV file

Before starting an import, make sure your file is properly formatted:
  • Format — .csv with a single sheet
  • Size — under 30 MB
  • Encoding — UTF-8
  • Header row — column names must be present for field mapping

​
Formatting guidelines

​
Importing contacts

1

Open the Import wizard

In the Contacts section, click the Import icon at the top right of the toolbar.
Import icon in the toolbar

Click the Import icon in the Contacts toolbar to open the import wizard

2

Select objects to import

Choose Contacts, Opportunities, or both, then click Next.
Import object selection screen

Select which objects to import — Contacts, Opportunities, or both

3

Upload your file

Click Upload a File and select your CSV. The system uses email addresses (then phone numbers) as the default unique identifier for deduplication.
Upload CSV file step

Click Upload a File to select your prepared CSV

Click Next to proceed.
4

Map fields

Map each column in your CSV to the corresponding Hoop contact field. Use the Preview column to verify the mapping is correct.
Field mapping screen

Map each CSV column to the corresponding contact field in Hoop

5

Configure post-import preferences

Set optional preferences for what happens after import:
  • Create a Smart List — automatically creates a smart list containing all newly imported contacts
  • Add to workflow — enroll imported contacts in an automation
  • Add tags — apply one or more tags to all imported contacts
Post-import preferences screen

Configure smart list, workflow, and tag preferences for imported contacts

6

Review and start the import

Cross-check the CSV against your field mapping. Check the compliance checkbox to confirm that all contacts have explicitly opted in to receive communications. Then click Start Bulk Import.
Import field confirmation screen

Review your field mapping before confirming the import

Monitor progress in the Bulk Actions tab under Contacts.
Import progress in Bulk Actions tab

The import runs in the background — track progress in the Bulk Actions tab

Contact imports cannot be reversed directly from the import wizard. To undo a mistaken import, go to Contacts > Bulk Actions, find the import action, and use the restore option in the three-dot menu.

​
Importing contacts with shared information

When multiple contacts share the same address, company, phone number, or email address, you need to configure deduplication settings first.
1

Adjust deduplication settings

Go to Settings > Business Profile and scroll to Contact Deduplication Preferences.
  • Enable Allow Duplicate Contacts to permit new contacts to share identifiers with existing ones
  • Configure the primary and secondary search preferences to match your import strategy
When “Allow Duplicate Contacts” is on, importing a contact with matching identifiers creates a new contact. When off, it updates the existing record instead.
2

Run the import

Follow the standard import steps above. On the Upload step, select Create and update contacts as the import mode to ensure new entries are added without overwriting existing records.
Import complete confirmation

The completed import with all contacts successfully imported

​
Troubleshooting import errors

1

Navigate to Bulk Actions

Go to Contacts > Bulk Actions and locate your import in the list.
2

Review import statistics

Click Show Stats to see a breakdown of total contacts, successful imports, and errors.
3

Examine error details

Click the Error tab to see errors organized by line number. Each line number corresponds to a row in your CSV (Line 1 = first contact).

​
Common errors and resolutions

​
Troubleshooting tips

  • Pre-validate your data — use spreadsheet software to check for missing values, formatting issues, and inconsistencies before importing
  • Test with a small batch — import 5–10 rows first to confirm field mapping is correct before doing a full import
  • Check for hidden characters — spreadsheet software sometimes adds invisible characters; resave as plain CSV if issues persist

​
Frequently asked questions

Yes. On the first step of the import wizard, select both Contacts and Opportunities. Map fields for both objects during the mapping step.
Double-check the CSV for hidden formatting issues. If problems persist, contact Hoop support for further assistance.
Yes. Navigate to Contacts > Bulk Actions, find the import, and use the restore option in the three-dot menu to revert the imported contacts.
Map additional email columns during the field mapping step. The system will assign them as secondary email addresses on the contact record.
Last modified on March 22, 2026