Merging Duplicates from a List You Already Have

header-duplicate-cats-crewing.png

If you already know which records are duplicates — for example, from an export out of your CRM's native duplicate detection tool, an external audit, a data migration, or a report from another system — you can skip Insycle's field-based duplicate detection entirely. The CSV tab in Step 1 of the Merge Duplicates module lets you upload a list of known duplicate record ID pairs directly, then use Insycle's merge configuration to handle the consolidation.

This approach works with any supported CRM, including HubSpot and Salesforce. No custom CRM fields are required.

Configuring Deduplication Using a CSV

Preparing Your CSV File

The CSV must include a header row with exactly two column names: ID_1 and ID_2. Each subsequent row should contain the record IDs of one duplicate pair. Any additional columns in the file are ignored — Insycle only processes the ID_1 and ID_2 columns.

Note: Values must be at least 4 characters long to be recognized. Record IDs shorter than 4 characters will not be processed.

merge-duplicates-ID_1-ID_2-pairs-merge-csv.png

The image above shows a CSV file open in a spreadsheet application, showing a header row with ID_1 and ID_2 columns and several rows of record ID pairs below

Uploading Your CSV

  1. Navigate to Data Management > Merge Duplicates and select your database and object type.
  2. In Step 1, click the CSV tab.
  3. Click Upload and select your file.
merge-duplicates-step-1-csv-tab-646w.png

The image above shows Step 1 of the Merge Duplicates module, with the CSV tab selected and the Upload button visible.

Once uploaded, Insycle validates that the record IDs in the file exist in your CRM. Rows with invalid or missing record IDs are skipped and will not appear in Step 2.

Completing the Merge

After uploading your CSV, continue through the remaining steps to configure and run the merge:

  1. In Step 2, review the duplicate groups Insycle has assembled from your CSV pairs to confirm the records look correct before proceeding.
  2. In Step 3, configure your master selection rules on the Master tab and any field data retention rules on the Fields tab.
  3. In Step 4, run in Preview mode first to verify the merge results, then switch to Update mode to apply the changes to your CRM.

Troubleshooting

Valid record IDs are not appearing in Step 2

If records you know exist in your CRM are not appearing after upload, your Insycle data may not yet reflect the most current state of your CRM. Navigate to Settings > Accounts and trigger an incremental sync. If the records still do not appear after syncing, contact Insycle Support to request a full sync.

For more troubleshooting help with merging, see Merge Duplicates Troubleshooting.

Additional Resources

Frequently Asked Questions

Related Help Articles

Related Blog Posts