NetFarmer Blog

What a HubSpot Integration Project Should Deliver: A Buyer’s Checklist

Written by NETFARMER | 12 Nov 2026, 5:30:00 am

When you first contact a vendor or partner about a HubSpot integration project, you should leave with knowing what your team needs to achieve, what the proposed work includes and who will take responsibility for delivering it.

Checklist Summary:

  • Define the scope and responsibilities
  • Clarify field mappings and identity rules
  • Verify historical data and migration checks
  • Test normal workflows and failure scenarios
  • Acceptance based on a customer journey
  • Confirm support and ownership after launch

1. Define the scope and responsibilities

Ask for a written scope that identifies the systems, accounts, records and workflows included.

It should specify:

  • Which contacts, companies, deals, tickets or other records are covered.
  • Which data moves in each direction.
  • What triggers an update and how quickly it should arrive.
  • Whether historical migration is included.
  • Which subscriptions, licences and access permissions are required.
  • What is explicitly excluded.

There should also be people in your team that are responsible for overseeing the project. Think responsibilities such as approvals, data governance, access etc.

Separate essential deliverables from items that apply only to your project, such as historical migration, and separately priced work, such as additional workflows. Otherwise, two apparently similar quotes may cover very different jobs.

 

2. Agree how data will be matched and updated

It is good practice to include a field mapping document before development begins. This should track all the fields that your company uses or would like to get added.

For each field, it should show the source, destination, format, update direction and what happens when values conflict. Agree whether an empty field can overwrite an existing value and which system takes precedence.

 HubSpot uses custom identifiers such as Record ID, email and properties requiring unique values for matching imported records. For example, ask what happens if a customer changes their email address, should the integration update the existing contact or create another one?  Clarify on how it works before the go-ahead with the data transfer.

 

3. Verify historical data and migration checks

Before migration, make sure that the scope of data to be moved over is aligned. Agree the date range, record types, attachments and exclusions before the work begins.

Afterwards, confirm that records retain the correct owners, relationships and relevant history. Require a list of failed or excluded items, with a named person responsible for resolving or accepting each exception.

 

4.Test normal workflows and failure scenarios

When testing if the setup in HubSpot works, things to look out for include:

  • Updates to existing records.
  • Missing or invalid information.
  • Duplicate events.
  • Conflicting changes.
  • Lost authorisation.
  • Temporary service interruptions.
  • Failed attachments, where relevant.

Your deliverables should include test results, unresolved issues and an agreed retry or manual recovery procedure.

 

5. Approve the complete customer journey

Define completion through a customer journey your team recognises.

For example, use an anonymised enquiry from your own records, with permission. Check that it reaches the right HubSpot contact, creates the agreed activity or ticket, assigns the correct owner and supports the intended follow up.

Then test a failure and recovery. Record the expected outcome, actual result and evidence.

 

6. Confirm support and ownership after launch

Ask for an operational handover and explicit support responsibilities.

The handover should cover:

  • Administrative access and permissions.
  • Monitoring and error alerts.
  • Recovery instructions.
  • Named support contacts and escalation routes.
  • Documentation your team can maintain.

Transfer credentials securely rather than placing them in general project documents.

Separate defect correction from ongoing maintenance. Agree coverage hours, response expectations and how new requirements or platform changes will be charged.

 

Looking for a HubSpot implementation partner?

Talk to NetFarmer about the systems you need to connect and the workflows you want to improve. We’ll help you define the scope, clarify delivery responsibilities and agree what a successful implementation should look like before the project begins.

Set up a quick call with NetFarmer to discuss your HubSpot integration requirements today.