Intercom Magical Import Overview


Magical Import for Intercom allows you to import data flexibly and powerfully.

With Magical Import you can do the following while importing:

  • Map fields and save templates for future mapping
  • Create straightforward rules for when your data is updated, overwritten, or appended
  • Compare data to existing Intercom fields
  • Deduplicate data while importing
  • Cleanse data while importing
  • Format and standardize
  • View changes in the activity tracker at any time

Using Magical Import, you can create straightforward rules to determine when your data is updated, overwritten, or appended. You’ll ensure that you are able to enforce data quality and consistency standards while importing new data with confidence.

Use Cases

Sample Use Case: Import New Records or Update and Append to Existing From CSV

How It Works

When you click to upload a CSV to Insycle, it doesn't import to the CRM right away. Instead, it loads your CSV into Insycle for preprocessing.

Using Insycle you can format, standardize, and cleanse the data before it's imported to the CRM (instead of using Excel or other tools). And when you use templates, anyone on your team can prep the data consistently.

Insycle also helps you avoid duplicates from getting created as a side effect of the import. The way it does it is by letting you define unique identifiers for the records. Insycle compares and matches the CSV rows to the CRM data.


With Insycle, you can import Intercom data flexibly and powerfully.

The process is simple. First, we connect CSV columns to fields in Intercom and tell Insycle whether to update existing records, create new records, or do both depending on what is in your Intercom database. Then, you prepare the data before importing—cleansing, formatting, standardizing, and updating.

Supported Intercom Record Types

Insycle's Magical Import module for Intercom supports the following Intercom record types:

  • Users
  • Leads
  • Companies
  • Tags

You can select the record type that you would like to import at the top of the module screen.

Identity Fields

Insycle uses Identity Fields to compare your CSV to your Intercom data. Identity fields must be "unique identifiers." These are data points that could only belong to a single contact—such as email addresses, phone numbers, home addresses, or ID numbers.

email identity field

Please Note

You can select more than one identity field however, this will cause Insycle to check that ALL of the fields match, not just one of the fields. If one single field does not match, the corresponding matching CRM record will not be identified. If you include six identity fields and five of them match but one does not, Insycle will not identify the record as a match.

Using the "Update Existing and Create Net New" setting, Insycle will fail to match many records and instead will create a new record.

If you use the 'Only Update Existing' setting with many Identity Fields, you will identify far fewer existing records and much of your CSV data will not be imported because Insycle will not be able to find the correct record to update.

too specific

Outside of specific use cases, it is typically best to use a single identity field.

Additionally, do not set your identity field too broad, such as using a field that is not uniquely identifying. Doing this means that Insycle is likely to identify the wrong record in your CRM as a match, and update the wrong record with data from your CSV. For instance, there are probably many people with the first name 'John' in your CRM, but you want to make sure that you are updating the correct record for John. This is why it is important that we use uniquely identifying fields.

too broad


With your Intercom import set up and running smoothly, you can then save your settings as a template. With a template, all of your settings are saved including field mapping, functions, import modes, etc.

Then, any time that you import data using the same CSV structure and select the template, these settings will be automatically loaded and you will have minimal work for future imports.


To create and save a new template, click the “+” symbol on the right-hand side of the template banner.

template save

After creating the template, you must save the template by clicking the save (disk) icon on the far right-hand side of the same menu.

Audit Trail and History

The Activity Tracker lets you review all changes made to Intercom data through Insycle. At any time you can download a CSV report of the operation and records affected, including during imports.

Frequently Asked Questions

Does Insycle Automatically Map My CSV Files to My App Fields?

Yes, Insycle will automatically map fields that it is able to identify. However, Insycle may not be able to map every field. When it cannot map a field, a notification will appear.


Can Insycle Append New CSV Data to Existing Records?

Yes, you can easily append data to existing data by selecting "Append" from the mapping section.


Can I clean import data before it is added to my CRM?

Yes, Insycle allows you to apply many functions to specific data fields to clean, format, and standardize data on the way into your database.

prepare data

Can Insycle Associate contacts to companies on import?

Yes, Insycle allows you to associate contacts, companies, deals, and custom objects while importing data from a CSV, using the "Associate" or "Link" tab in Step 4 (depending on the verbiage used by your app).


Can Insycle compare CSV data to existing data in my CRM

Yes, Insycle allows you to compare in different ways using the Pull and Compare features. To learn more click here.

When should I use the "Compare" Feature?

Use the "Compare" feature when you want to use your CSV to view other data in your CRM for the same records.

For instance, Insycle might use the "email" field in your CSV to identify the matching record in your CRM, then you can view all additional fields for those matched records in a CSV.

When should I use the "Pull" Feature?

Use the "Pull" feature to see if your CSV data is already present in your CRM. This is great for trimming your CSV files and keeping yourself from creating duplicates when uploading new lists.

Additional Resources

Related Blog Posts

Related Help Articles

CRM Specific Information