Documentation

Complete guide to using Emergency Unmerge  |  Last updated: March 29, 2026

1. Getting Started

Once installed, a sidebar card labeled "Emergency Unmerge" appears on every contact, company, and deal record in your HubSpot portal.

For a visual walkthrough with demo videos, see the Setup Guide.

Adding Cards to Record Pages

After installation, add the Emergency Unmerge cards to your record page layouts. Repeat these steps for Contacts, Companies, and Deals:

1. Go to Settings → Data Management → Objects and select the object type.
2. In the record page editor, create a new tab named "Emergency Unmerge".
3. Click "Add card" and search for "Unmerge" in the card library.
4. Add the Emergency Unmerge Tab card to the middle column.
5. Add the Emergency Unmerge sidebar card to the right column.
6. Click "Save and exit".

2. Scanning a Merged Record

Navigate to a record that was created by an accidental merge. The Emergency Unmerge sidebar card will appear on the record page.

1. Click "Scan Record" in the sidebar card.
2. The scan is completely free: no credits are charged.
3. Within seconds, the scan returns:
   • Whether a merge was detected
   • Number of properties, associations, and activities involved
   • Complexity assessment (simple vs. complex)
   • Exact credit cost for reconstruction

If a chain merge is detected (the record was merged multiple times), the scan will show how many merge events occurred.

3. Reconstruction

After reviewing the scan results and purchasing credits (if needed), click "Generate Reconstruction Plan".

The system (Anthropic's Claude) analyzes:

• Property history: every field's values, timestamps, and sources
• Timestamp forensics: when values were set vs. when the merge happened
• Association patterns: which contacts, companies, deals, emails, notes, tasks, calls, and meetings belong to which original record
• Email domain forensics: matching email domains to company records

Reconstruction typically takes 1-2 minutes depending on complexity.

4. Reviewing the Reconstruction

After reconstruction, you enter the Review step. Here you can inspect the reconstruction before anything touches your CRM.

• Side-by-side view: see both reconstructed records (primary/surviving and secondary/restored) with all their properties and associations
• Confidence scores: every property shows a confidence percentage (how certain the system is about the attribution)
• Property history dropdowns: for any field, select from all historical values if you disagree with the system's choice
• Swap All: if the system reversed primary/secondary, one click swaps everything
• Copy JSON: copy the full reconstruction JSON for manual verification

5. Executing the Unmerge

Once you're satisfied with the reconstruction, click "Execute Unmerge".

During execution, Emergency Unmerge:

1. Captures a pre-execution snapshot of the current record state (all properties + associations)
2. Creates a new record with the secondary/restored properties (this record will have a new HubSpot Record ID)
3. Saves original read-only values (Create Date, Record ID, analytics source, etc.) to the "Emergency Unmerge" property group
4. Reassigns associations (contacts, companies, deals, activities) to the correct records
5. Sets metadata properties on both records (unmerge date, original ID, details)
6. Captures a post-execution snapshot of all affected records

6. Post-Execution Property Editor

If the reconstruction got a property wrong - or you just want to change a value - use the Property Editor on your account history page.

1. Go to your account dashboard
2. Find the completed operation in the history table
3. Click "Edit Properties" in the actions column
4. A modal opens showing every property for each record:
   • Properties with multiple historical values show a dropdown with all past values, timestamps, and sources
   • Properties with a single value show the current value with an "Edit" link for manual entry
5. Select the correct value from the dropdown and click "Save"
6. The value is written directly to HubSpot - no credits charged for corrections

7. Association Editor

After executing an unmerge, you may need to reassign associations between the separated records. The Association Editor provides full control over associations on both records.

1. Go to your account dashboard
2. Find the completed operation in the history table
3. Click "Associations" in the actions column
4. The editor shows all current associations on both records (contacts, companies, deals, notes, tasks, calls, emails, meetings)
5. For each association, you can:
   • Move: Transfer the association from one record to the other
   • Add: Create a new association on either record
   • Remove: Delete an association from a record

The editor also shows the AI's original recommended assignment for each association, so you can compare what the system suggested with what is currently live in HubSpot.

8. Analysis Export

Download the full reconstruction analysis as a JSON file for compliance, auditing, or manual verification.

The export includes:

• Per-property attribution: Which record each property was assigned to, with confidence scores and reasoning
• Association mappings: Which associations were assigned to which record, with reasoning
• Activity clustering: How engagement activities (emails, calls, notes, tasks, meetings) were grouped and attributed
• Merge forensics: Timestamps, merge event chain, and property history analysis
• Processing metadata: Token usage, model used, processing duration

To download:

1. Go to your account history
2. Find any operation that has completed reconstruction (or later)
3. Click "Download Analysis" in the actions column
4. A JSON file downloads with the complete analysis data

9. Operation History & Credit Ledger

Your account dashboard shows a complete history of all operations with:

• Summary stats: total operations, completed count, and total credits spent
• Operation table: date, type, record ID, status, credits charged, and confidence score for each operation
• Expandable detail rows: click any row to see:
  • Operation ID
  • Credits charged (with USD equivalent)
  • Processing model used
  • Started/completed timestamps and duration
  • Token counts (input/output)
  • Complexity breakdown (properties, associations, activities, merge type)
  • Error details (if the operation failed)
• Actions: Resume, Edit Properties, Edit Associations, Download Analysis, Download Snapshots, Cancel

Below the operations table, the Credit Transaction Ledger shows every credit transaction: purchases, deductions, and refunds with dates and descriptions.

10. Recovery Snapshots

Every execution automatically captures JSON snapshots of all affected records - both before and after the unmerge. These include every property and association on each record.

To download snapshots:

1. Go to your account history
2. Find the completed operation
3. Click "Snapshots" in the actions column
4. A JSON file downloads containing the full pre/post record states

11. Chain Merges

A chain merge happens when a record was merged multiple times (e.g., A merged into B, then B merged into C). Emergency Unmerge detects chain merges automatically during the scan.

• The scan shows how many merge events occurred and displays a Merge Timeline with dates and record names for each event
• You can select a specific merge event from the timeline to undo just that one merge, or choose to reconstruct all records at once
• During review, you see the reconstructed records with confidence scores - tabs for each record if reconstructing all, or a standard primary/secondary view if targeting a single event
• Execution creates the separated records - either all abolished records at once, or just the one you selected

Chain merges may require more credits due to increased complexity.

12. Bulk Scan Overview

The Free Bulk Scan lets you scan up to 10,000 records at once by uploading a CSV file or selecting a HubSpot List/Segment. It detects every merged record in your set, classifies merge type and complexity, and estimates the unmerge cost for each one. The scan is completely free and makes no changes to your CRM.

Once you have the scan results and know the scope, you can download the full findings as a CSV. If you decide to proceed with unmerging, the actual bulk unmerge is handled as a guided recovery: we run the rebuild with you so the reconstruction order and re-association are done safely. See Section 14: Guided Bulk Recovery for how to start.

Supported Sources

The Free Bulk Scan accepts three sources:

• HubSpot Merge History Export (CSV): Contains columns like Merged Object ID, Resulting Object ID, Performed by, and Merge happened at. Export this from HubSpot under Reporting > Merge History.
• View / Segment Export (CSV): A standard HubSpot view or list export containing a Record ID column (or similar ID column). Use this when you have a list or view of records you want to check.
• HubSpot List / Segment (Direct): Select any existing Contact or Company list directly from your HubSpot portal. No CSV export needed. The system fetches the record IDs from the list automatically. Supports Active (dynamic), Static, and Snapshot lists.

For CSV uploads, the system auto-detects the format. For HubSpot Lists, select the list from the dropdown and click "Load Records."

What the Scan Returns

For each record in your set, the scan checks merge history and returns:

• Whether a merge was detected on that record
• Merge type and classification (simple vs. complex, chain merge, etc.)
• Number of properties, associations, and activities involved
• Estimated credit cost to unmerge that record

Records where no merge is detected are marked and excluded from the cost estimate. The scan summary shows the total count of merged records found and the total estimated cost across the set.

Downloading the CSV Report

After the scan completes, download the results as a CSV file from your account dashboard. The CSV includes per-record details: merge detection status, complexity, and estimated unmerge cost. Share it with stakeholders or use it to prioritize which records to recover first.

13. Free Bulk Scan

The Free Bulk Scan is a read-only tool for assessing the scope of a merge problem across many records at once. It detects every merged record in your input set, classifies the merge type and complexity, and estimates the cost to unmerge each one. No changes are made to your CRM and no credits are charged.

Use the Free Bulk Scan when you want to:

• Find out how many records in a list or export were affected by bad merges
• Understand the complexity and estimated cost of a bulk recovery before committing
• Generate a report to share with your team or leadership before taking action
• Prioritize which records to recover first based on complexity or cost

Start a Free Bulk Scan from the Bulk Scan section on your account dashboard. Upload a CSV or select a HubSpot List, choose the object type (contacts or companies), and click "Start Scan." See Section 12 for supported sources and what the scan returns.

Scan Report (CSV Download)

After the scan completes, download the results as a CSV from your account dashboard. The report includes per-record details: merge detection status, merge type, complexity classification, and estimated unmerge cost. Use it to review scope and share findings with stakeholders before deciding how to proceed.

14. Guided Bulk Recovery

Once your Free Bulk Scan is complete and you know the scope, the next step is a guided bulk recovery. We run the bulk unmerge with you so the reconstruction order and re-association logic are handled safely from start to finish.

Bulk unmerge involves rebuilding many records in a specific sequence, re-attaching associations correctly, and verifying results at each phase. Doing this safely at scale requires the right order of operations and checks that go beyond what a self-serve tool can guarantee. A guided recovery ensures none of that is left to chance.

How to Start

1. Complete a Free Bulk Scan and download the scan report
2. Review the report to confirm scope and decide which records to recover
3. Contact us at joshua@thirdspaced.com or book a call to start a guided recovery engagement
4. We scope the job with you, agree on the approach, and run the bulk unmerge together

15. Credits & Billing

Credit Packages

• Per-Credit - from $0.05 each: Buy exactly how many you need. $0.05/credit under 250, or $0.04/credit at 250+. 100 credit minimum ($5.00), no bundles required.
• 100 Credits - $4.99 ($0.05 per credit): Convenient bundle for simple to medium unmerges.
• 250 Credits - $9.99 ($0.04 per credit): Mid-range option for complex records or small batches.
• 500 Credits - $19.99 ($0.04 per credit, save 20%): Best value for teams or bulk unmerges.

How Credits Are Used

• Credits are charged when reconstruction begins (not during scanning)
• Cost depends on record complexity - number of properties, associations, and activities
• The scan step is free and shows the exact credit cost before you commit
• The Free Bulk Scan is also free and never charges credits
• Credits never expire
• CRM Data Backup & Restore subscribers: Paid CRM Data Backup & Restore plans include a monthly Emergency Unmerge allowance (10-200 operations/month depending on plan tier). The allowance covers unmerge operations, single or bulk (one record equals one operation). Merge audits are billed in credits and do not draw from the allowance. Snapshot-based restores never use the allowance; they are free with CRM Data Backup & Restore.

Refunds

• Credits are automatically refunded if reconstruction fails (API error, timeout, system failure)
• Credits are not refunded for successful reconstructions you are dissatisfied with, user error, or approved executions
• The Property Editor lets you correct fields at no additional cost

Payments are processed by Stripe. We never store credit card numbers.

16. Disconnecting & Uninstalling

How to Disconnect Emergency Unmerge

Disconnecting revokes Emergency Unmerge's OAuth access to your HubSpot portal. Your credit balance and operation history are preserved.

1. In HubSpot, go to Settings → Integrations → Connected Apps.
2. Find Emergency Unmerge in the list.
3. Click the Actions dropdown and select Disconnect.
4. Confirm the disconnection.

What happens when you disconnect:

• Emergency Unmerge can no longer access your HubSpot CRM data.
• Any in-progress operations will fail (credits are auto-refunded for reconstruction failures).
• Your credit balance and operation history are preserved: if you reconnect later, they will still be available.
• Custom properties written by Emergency Unmerge (e.g., eu_unmerge_date, eu_unmerge_details) remain on your records.
• Records created by previous unmerge operations are not affected: they remain in your CRM.

How to Uninstall Emergency Unmerge

Uninstalling removes the app entirely from your HubSpot portal, including the CRM cards.

1. In HubSpot, go to Settings → Integrations → Connected Apps.
2. Find Emergency Unmerge in the list.
3. Click the Actions dropdown and select Uninstall.
4. Confirm the uninstallation.

What happens when you uninstall:

• The Emergency Unmerge sidebar card and tab card are removed from all record pages.
• OAuth tokens are deleted from our servers.
• Your credit balance and operation history are preserved on our side - if you reinstall later, your account is restored.
• Records and properties created by previous operations remain in HubSpot unchanged.
• No HubSpot data is deleted by uninstalling Emergency Unmerge.

17. Troubleshooting

"No Merge Detected"

This means HubSpot's property history doesn't show a merge event on this record. Possible causes:

• The record was not created by a merge (it may have been duplicated another way)
• The merge happened so long ago that the relevant property history has been overwritten
• You're looking at the wrong record - try the other record involved in the merge

Reconstruction Seems Inaccurate

• Use the Property Editor after execution to correct individual fields
• Check if the primary/secondary records are swapped - use "Swap All" during review
• Records with very few properties or overlapping values are harder for the system to disambiguate

Operation Stuck or Failed

• Check your operation history for error details
• Failed operations receive automatic credit refunds
• If an operation is stuck, you can cancel it from the history page
• Contact joshua@thirdspaced.com for persistent issues

Need Help?

Contact us at joshua@thirdspaced.com or use the support form. Include your HubSpot Portal ID and operation ID if available.