How to import and manage contacts on Freshdesk

beginner 8 min read Updated 2026-03-18

Quick Answer

Import contacts to Freshdesk by navigating to Admin > Contacts > Import, uploading a CSV file with proper field mapping. Manage contacts through the Contacts section where you can edit, merge, segment, and organize contact information.

Try Freshdesk Full Freshdesk Review

Prerequisites

Active Freshdesk account with admin or agent permissions
Contact data in CSV format with proper column headers
Understanding of contact fields and data structure
Access to Freshdesk Admin settings

Step-by-Step Instructions

Access the Contacts Import Section

Log into your Freshdesk account and navigate to Admin in the left sidebar. Click on Contacts under the Customer Management section, then select Import from the dropdown menu. This will open the contact import wizard.

Ensure you have admin privileges to access the import functionality.

Prepare Your CSV File

Download the sample CSV template by clicking Download Sample CSV. Format your contact data with columns like Name, Email, Phone, Company, and any custom fields. Ensure email addresses are unique and properly formatted. Save your file as a CSV format with UTF-8 encoding to handle special characters correctly.

Keep your CSV file under 10MB and limit to 25,000 contacts per import for optimal performance.

Upload and Map Contact Fields

Click Choose File and select your prepared CSV file. Once uploaded, Freshdesk will display a field mapping interface. Map each column from your CSV to the corresponding Freshdesk contact fields such as Name, Email, Phone, Job Title, and Company. Review the preview to ensure data alignment is correct.

Use the 'Skip' option for any CSV columns you don't want to import into Freshdesk.

Configure Import Settings

Select your import preferences: choose Skip duplicates to avoid importing existing contacts, or Update duplicates to refresh existing contact information. Set the Time Zone for proper date field handling. Click Import Contacts to begin the import process.

Enable email notifications to receive import completion status and error reports.

Monitor Import Progress and Results

Track the import progress on the import status page. Once completed, review the import summary showing successful imports, duplicates skipped, and any errors. Download the error report if any contacts failed to import, and check the Recent Imports section for historical import data.

Large imports may take several minutes to complete - don't refresh the page during processing.

Organize Contacts with Groups and Segments

Navigate to Contacts in the main menu to manage imported contacts. Create contact groups by clicking Add Group and defining criteria like company, location, or custom fields. Use the Advanced Filter option to segment contacts based on specific attributes and save these filters for future use.

Use contact groups to streamline targeted communications and ticket management.

Edit and Update Contact Information

Click on any contact name to open their profile. Update contact details in the Contact Information section, add notes in the Description field, and assign custom field values. Use the Merge Contacts feature to combine duplicate entries by selecting multiple contacts and clicking Merge.

Regularly audit and clean your contact database to maintain data quality and avoid duplicates.

Export and Backup Contact Data

To export contacts, go to Admin > Contacts > Export. Select your export criteria including date range, contact groups, and specific fields to include. Choose between CSV or Excel format and click Export. Download the file from the export history once processing is complete.

Schedule regular contact exports as backups and for integration with other business systems.

Common Issues & Troubleshooting

CSV import fails with 'Invalid file format' error

Ensure your file is saved in proper CSV format with UTF-8 encoding. Remove any special characters, formulas, or formatting from Excel before saving as CSV. Check that required fields like Email are properly formatted and not empty.

Contacts appear as duplicates after import

Freshdesk identifies duplicates by email address. Clean your CSV data to remove duplicate emails before importing, or use the Update duplicates option during import to refresh existing contact information instead of creating new entries.

Custom fields not importing correctly

Verify that custom fields exist in your Freshdesk account before importing. Go to Admin > Contact Fields to create missing custom fields. Ensure the field types match your CSV data (text, number, date, etc.) and field names are mapped correctly during import.

Unable to merge duplicate contacts

Check that you have sufficient permissions to merge contacts. Select only contacts with the same contact type (individual vs company). If contacts have conflicting ticket histories, resolve those manually before attempting to merge, or contact Freshdesk support for assistance with complex merges.

Prices mentioned in this guide are pulled from current plan data and may change. Always verify on the official Freshdesk website before purchasing.

Visit Freshdesk View Freshdesk Pricing