Export CRM Data for CSV Comparison or Enrichment

How to Leverage CRM Data to Analyze or Enhance External Sources

You have important data in multiple sources and want to use your CRM data for analysis and enrichment. Comparing or combining these data sources has been a challenge, but it's crucial for getting a complete picture.

Using the Export feature in the Magical Import module, you can match CSV entries with CRM records and selectively export field data from the matched records.

Process Summary

  1. Select the CSV file for comparison.
  2. Ensure the Matching Criteria maps the CSV column and CRM field correctly.
  3. Select the fields you want to export CRM data from.
  4. Export CRM data to CSV file.

 

Step-by-Step Instructions

Step 1: Upload Your CSV and Map Columns to Your CRM

Select the CSV File for Matching Records

Navigate to Data Management > Magical Import. Select the database and the record type in the top menu.

Choose the CSV file that you would like to match to CRM records and export data from. This file will not be uploaded to your CRM.

Map CSV Columns to CRM Fields

After uploading your CSV data, Insycle analyzes your file and compares the columns in the file to fields in your CRM database, mapping recognized fields for you. 

If your CSV contains fields that are not matched to your CRM, a red error notification icon will show. When using the Export feature, the only column that must be mapped correctly is the one used as your Matching Criteria in Step 2. Other columns will be ignored.

magical-import-hubspot-contacts-step-1-warning-not-mapped-email.png

Step 2: Export CRM Data for CSV Review or Enrichment

Export provides a simple CSV report by using the list of entries from your source CSV to retrieve existing data for specific fields from your CRM records.

Under Step 2, click the Export tab.

Select the Matching Field to match CSV data to records in your CRM. This should be a field where both the CSV and CRM have the same value. This needs to be a unique identifier that would only belong to a single record—such as an email address, phone number, or ID number. 

Note that when using an email field, Insycle will automatically cross-reference any additional email fields in the records for a match. If using a domain field, Insycle will check additional domain fields.

magical-import-hubspot-contacts-step-2-export-identity-field-email-no-fields.png

Once you've selected the Matching Field, the CSV data in Step 1 will be updated to reflect which rows matched records in your CRM. The row number and Matching Field will become links to the corresponding CRM records.

Rows from your CSV that do not match records in your CRM will display an error message. To filter these out so Insycle only includes matched rows in the export, select Only Valid from the filter in the Step 1 heading.

magical-import-hubspot-contacts-step-1-only-valid.png

In Step 2, define the Fields to Export. These are the CRM fields that you would like to pull data from to analyze, compare with your CSV data, or use for enrichment. You may want to include your Matching Field and other key fields.

magical-import-hubspot-contacts-step-2-export-ID=email-fields-city-company-email-name-phone.png

Click the Export button, then click the Run ID in the Export Result popup, or go to your email to download the compare CSV.

All the data for the Fields to Export that you selected will be included for each CSV row for which a CRM match was found. Then, you can analyze this data, compare it to your CSV, or use it to enrich another source. 

magical-import-hubspot-contacts-export-fields-city-company-email-name-phone-csv.png

Export Feature vs Compare (Preview) Feature

Both the Export and Compare (Preview) features in Step 2 will provide a CSV report based on the rows in your initial CSV. Insycle will look for matching records in your CRM and include field data in the CSV report. These are read-only operations.

Use the Export feature if you want to select fields from your CRM to include in an export. Select as many fields as needed for analysis or import into another resource.

Use the Compare (Preview) feature if you want to see the values from your initial CSV compared side-by-side with the values from the CRM. This report lets you preview potential changes to existing records upon import and also identifies new data not found in your CRM.

Learn more about using the Compare (Preview) to compare CSV data to existing records in your CRM.

Advanced How-Tos

Selecting Matching Criteria

Insycle uses Matching Criteria to compare the CSV with your CRM data and identify existing records for the same entity. Matching Criteria are rules based on unique identifiers that typically belong to only one entity, such as:

  • Email address
  • Company domain (for business records)
  • Phone number
  • ID number
  • Street address

Note that when using an email field, Insycle will automatically cross-reference any additional email fields in the records for a match. If using a domain field, Insycle will check additional domain fields. 

You can set multiple matching rules that are evaluated in order from top to bottom. This allows you to find matches based on various criteria, all in one step. 

For example, you could use the following criteria to match contact records:

  1. Email address
  2. First Name + Last Name + Company Name
  3. First Name + Last Name + Phone Number

magical-import-step-2-matching-criteria-610x269.png

Insycle attempts to match each CSV record using the first rule. If no match is found, it proceeds to the next rule, continuing until either a match is found or all rules are exhausted (in which case the CSV record is considered new or unique).

For best results, place your most precise matching criteria at the top of your rule list. Additionally, keep in mind that while names can be included as part of the matching criteria, they should be used in conjunction with other identifiers, as multiple individuals may have the same name.

Important Note

You can select more than one field in each Matching Criteria rule; however, ALL of the fields must match, not just one or some of them. If you include five fields and four of them match, but one doesn't, Insycle will not consider the rule a match.

Typically, it is best to use a single field for your first Matching Criteria to improve the likelihood of finding existing records in your CRM. Then you can add additional rules to match multiple fields.

magical-import-step-2-export-too-many-identity-fields.png

Troubleshooting

Seeing red warning icon in Step 1

If there are issues with a CSV column, a red warning icon will appear at the top of the column. When using the Export feature, the only column that must be mapped correctly is the one used as your Matching Field in Step 2. You need to select the corresponding CRM field from the dropdown. Other columns will be ignored.

magical-import-hubspot-contacts-step-1-warning-not-mapped-email.png

If there are issues with a CSV row, the red warning icon will be shown on the left side of the table in Step 1. All rows with warnings will still be included in the generated CSV export, though they may also display error messages in the report. 

To learn what the problem is, hover over the red exclamation mark—an explanation of the error will display. 

magical-import-contacts-step-1-warning-duplicate-row.png

CSV records aren't being matched to CRM records

If a record in your CSV is not being matched to a CRM record and you know that it should be, there are several potential causes:

  1. The Matching Criteria you chose does not match between the CSV and CRM

    Insycle depends on your Matching Field selection to compare your CSV to your CRM data. If Insycle can't find matches between the two sources, you may need to find a more reliable but unique field.

    Have a look at the data in your CRM using the Grid Edit module, adding columns to the layout so you can explore the fields and values. Then, compare this against the columns and values in your CSV to find a field that dependably matches the two sources.

  2. You are using too many fields in the Matching Criteria rule

    You can select more than one field in each Matching Criteria rule; however, ALL of the fields must match, not just one or some of them. If you include five fields and four of them match, but one doesn't, Insycle will not consider the record a match.

    Typically, it is best to use a single field for your first Matching Criteria to improve the likelihood of finding existing records in your CRM. Then you can add additional rules to match multiple fields.

    magical-import-step-2-export-too-many-identity-fields.png

  3. Your Matching Criteria is too broad

    If you're using a field that is not truly unique as Matching Criteria, it's likely that Insycle won't be able to identify one single record as a match. For instance, there could be many people with the Industry "Media" in your CRM. This is why uniqueness is key.

    When selecting your Matching Criteria, make sure it is truly a "unique identifier." These are data points that would only belong to a single record—such as email address, phone number, street address, or ID number. For companies, it could also be company name, or company domain.

    magical-import-step-2-export-too-broad-not-unique-matching-field-646x302.png

  4. There is a syncing issue

    To refresh the data in Insycle, navigate to Settings > Sync Status, and next to the account name, click the Sync changes from last day button (lightning bolt icon). 

    settings-sync-status-sync-changes-from-last-day-hubspot.png

    Alternatively, you could log out of Insycle and then log back in.

    For help re-syncing a specific field, contact support.

For general troubleshooting advice, see our article on Troubleshooting Issues.

Frequently Asked Questions

When should I use the Export feature?

Use the Export feature if you want to use entries in a CSV file to look up and export data from your CRM. Insycle will look for matching records in your CRM and include field data in the CSV report.

You can select as many fields as needed for analysis or import into another resource. 

This can help you to determine if you already have the records in your database, and, if you do, what data they contain. You could also enrich your external data source with data from your CRM. 

Does Insycle automatically map my CSV fields to my CRM fields?

Yes, Insycle will automatically map fields that it is able to identify. However, if there are cases where it can't figure out what a field should map to, a warning icon will appear, and the CRM field dropdown will say "Not Mapped." 

When using the Export feature, the only column that must be mapped correctly is the one used as your Matching Field in Step 2. You need to select the corresponding CRM field from the dropdown. Other columns will be ignored.

magical-import-hubspot-contacts-step-1-warning-not-mapped-email.png

Additional Resources

Related Help Articles

Related Blog Posts