This checklist covers every step that needs to be completed before a Salesforce to HubSpot migration goes live. It is organized in execution sequence. Complete them in order. Steps that are skipped in the interest of timeline consistently reappear as remediation projects after go-live.

Use this as your project tracking document. Each step should have an owner, a completion date, and a sign-off. If a step cannot be completed, document why and what the impact will be on the migration outcome.


Phase 1: Data Audit (Complete Before Any HubSpot Configuration Begins)

Salesforce Database Assessment

  1. Pull a full contact export and run a duplicate analysis. Document the duplicate rate.
  2. Identify contacts not associated to any Salesforce account. Document the count and percentage.
  3. Run a field population report for all custom contact fields. Flag fields below 30% population.
  4. Run a field population report for all custom account fields. Flag fields below 30% population.
  5. Identify all custom objects in the Salesforce instance. Document record count and business use for each.
  6. Identify all Salesforce integrations: what systems connect to Salesforce, what data they exchange, and what the integration method is.
  7. Pull a list of all active Salesforce workflows and process builders that will need equivalents in HubSpot.
  8. Pull a list of all active Salesforce reports that stakeholders use regularly. These become the baseline for HubSpot dashboard configuration.
  9. Identify the Salesforce opportunity stages and document the business definition of each.
  10. Document the Salesforce lead source values in use. These map to HubSpot original source properties.

Attribution History Assessment

  1. Identify the attribution history period to migrate. Recommend 24 months minimum.
  2. Pull a report of all Salesforce campaigns that had responses in the attribution history period.
  3. Verify that campaign member records exist for those campaigns and document record count.
  4. Pull a sample of 10 recently closed-won opportunities. For each, document the marketing campaign touchpoints visible in Salesforce. This is the baseline for post-migration attribution validation.
  5. Identify any Salesforce activity types that should migrate as HubSpot timeline events for attribution history preservation.

Phase 2: HubSpot Instance Architecture (Complete Before Data Migration Begins)

Properties and Data Model

  1. Create HubSpot custom contact properties for every Salesforce custom contact field that will migrate. Match field type exactly.
  2. Create HubSpot custom company properties for every Salesforce custom account field that will migrate.
  3. Create HubSpot custom deal properties for every Salesforce custom opportunity field that will migrate.
  4. Configure HubSpot deal pipeline stages to match your Salesforce opportunity stage mapping. Document the stage mapping in a reference document.
  5. Define HubSpot lifecycle stages: map each stage to a specific behavioral or firmographic criterion. Get written agreement from sales and marketing before configuring.
  6. Configure lead source values in HubSpot to match your Salesforce lead source taxonomy.

Lead Scoring and Routing

  1. Design the HubSpot lead scoring model. Do not replicate the Salesforce lead scoring model automatically. Validate it against closed-won data first.
  2. Configure lead rotation and assignment rules in HubSpot. Match the territory and assignment logic from Salesforce.
  3. Configure the MQL workflow: what score threshold triggers MQL status, what notifications fire, what task is created for the assigned sales rep.
  4. Configure the MQL-to-SQL handoff workflow: what actions move a contact from MQL to SQL stage, what the SLA is for sales follow-up.

Attribution Infrastructure

  1. Define and document the UTM taxonomy that will be used for all marketing campaigns in HubSpot. Distribute to all campaign owners before go-live.
  2. Configure HubSpot tracking codes on all marketing properties.
  3. Configure the marketing attribution report: define first-touch, last-touch, and multi-touch attribution models.
  4. Build the marketing-sourced pipeline dashboard. Validate that it can produce a number before migration data is loaded.

Integrations

  1. Complete integration architecture decisions for every Salesforce integration identified in the audit.
  2. Configure and test each integration in a HubSpot sandbox environment before go-live.
  3. Document the data flow for each integration: what fields sync in which direction and on what trigger.

Phase 3: Migration Preparation (Complete Before Data Transfer Begins)

Data Preparation in Salesforce

  1. Deduplicate contact records in Salesforce using the duplicate rate identified in the audit.
  2. Associate unassociated contacts to accounts in Salesforce where account association can be determined.
  3. Archive Salesforce records that have been flagged for archival rather than migration.
  4. Update field values for any custom fields that are migrating where the current values reflect an outdated ICP or data model.
  5. Freeze Salesforce data entry for migrating record types during the migration window.

Migration Sequence Planning

  1. Document the migration sequence: companies first, then contacts with company associations, then open deals, then closed-won historical deals, then activity and campaign history.
  2. Assign a migration owner for each record type.
  3. Define the rollback protocol: what happens if a migration phase produces unexpected results and needs to be reversed.

Phase 4: Pre-Go-Live Validation

Data Integrity Checks

  1. Compare HubSpot company record count to Salesforce account record count migrated. Variance above 2% requires investigation.
  2. Compare HubSpot contact record count to Salesforce contact record count migrated. Variance above 2% requires investigation.
  3. Validate contact-to-company association rate in HubSpot against the pre-migration baseline.
  4. Validate open deal records: every deal should have at least one associated contact and one associated company.

Attribution Validation

  1. Run the attribution history validation against the five closed-won deals identified in step 14 of the audit. Verify that contact timeline events for campaign touches are visible in HubSpot.
  2. Run the marketing-sourced pipeline report for the 24-month attribution history period. Compare to the Salesforce equivalent report. Document any material variance and its cause.

Go-Live Readiness

  1. Complete sales team training on HubSpot before go-live. Training should cover daily workflow tasks, lead and deal management, activity logging, and how to read the pipeline attribution reports that were previously in Salesforce.

Post-Go-Live: 30-Day Hypercare Checklist

Daily: Pull the marketing-sourced pipeline report. Verify the number is moving in line with new deal activity and not showing unexpected changes from historical data.

Daily: Check the MQL workflow for unexpected triggers. Migrated contact records with pre-existing engagement history can trip lead scoring thresholds and fire MQL notifications for contacts that are not actually new prospects.

Weekly: Check contact-to-company association rate for new records created since go-live.

Weekly: Audit lead routing. Verify that new leads are being assigned to the correct sales reps.

Day 30: Run the full attribution validation again. Establish the post-migration attribution baseline.


Frequently Asked Questions

Do all 47 steps apply to every migration? Most do. Steps 30 through 32 scale based on how many Salesforce integrations you are managing. Steps 11 through 15 scale based on how much attribution history you are migrating. Every other step applies to every enterprise migration regardless of size or complexity.

How long does it take to complete this checklist? The full checklist runs 6 to 8 weeks for a standard enterprise migration. The data audit phase takes 1 to 2 weeks. The architecture phase takes 1 to 2 weeks. Migration preparation runs concurrently with architecture. Validation takes 3 to 5 days.

What is the most commonly skipped step? Step 46: the attribution validation comparing the HubSpot pipeline report to the Salesforce equivalent. Most migration teams validate data counts and record associations but do not run the pipeline attribution comparison before go-live. The result is discovering that attribution history is missing or inaccurate after the sales team has already been using HubSpot for two weeks.


The Pedowitz Group is a HubSpot Platinum Partner and 3x Marketo Partner of the Year and Eloqua Partner of the Year. If you want expert guidance through this checklist or a migration assessment before you begin, start here. Talk to TPG.