Skip to content
Get a quote

How do I import custom object records into HubSpot and link them to companies?

Short answer

First create the custom object, which needs an Enterprise subscription, and give it a unique-value property for the source ID. Then run a multi-object import: each row has the custom object's fields plus a company identifier, either the company domain or its Record ID. Map that identifier to Company to create the association. Smart Transfer can't move custom objects.

By

Steps

  1. Check the subscription. Custom objects need Enterprise in Marketing, Sales, Service, Data, Content, Smart CRM or Revenue Hub, and there are limits on how many objects and properties you can have.
  2. Define the object. Give it a primary display property, a unique-value property such as “Source ID”, and its association to Companies (and to Contacts or Deals if needed).
  3. Load the companies first, with domains, or note their Record IDs.
  4. Build the file:
Source IDNameStatusRenewal dateCompany domain
SUB-1001Gold planActive2027-03-01acme.com
SUB-1002Add-on seatsActive2027-03-01acme.com
SUB-1003Starter planCancelled2025-12-31globex.com
  1. Import multiple objects in one file: the custom object plus Companies. Map Source ID as the custom object’s unique identifier and Company domain to Company > Company domain name (or Record ID).
  2. Spot-check a few companies to confirm the custom records show in the association card.

What the native tools do / where they stop

ToolCustom objects
Smart Transfer”The transfer of custom objects isn’t supported”
Import toolSupported in single- and multi-object imports; matches on Record ID or a unique-value property
HubSpot paid CRM Data MigrationBronze: none; Silver: up to 2; Gold: up to 4
APIsFull support, with the same plan limits

HubSpot doesn’t give a worked example of linking custom objects to companies. In practice, the problem behind the community thread is identifiers. Companies without domains can’t be matched by domain, so export their HubSpot Record IDs after you load them and join those into the custom object file. And if the source has custom-to-custom relationships, such as a subscription with its invoices, load the parent object first, then the child, with the parent’s unique ID in each row.

Where FlitStack AI fits

FlitStack AI detects custom objects in the source and proposes the HubSpot schema and associations for your review. It then loads them in parent-to-child order. See the HubSpot import guide or HubSpot migrations.

Questions, answered

A few useful answers.

Can one custom object record link to several companies?

Yes. Use one row per custom-record–company pair with the same unique ID. HubSpot will update the record and add each association.

How many associations can a custom object have?

HubSpot's technical limits list 9 defined associations between each custom object type and other object types. Plan your association types with that in mind.

What if we're not on Enterprise?

You can't create custom objects. Flatten the data into properties, use notes, or repurpose a standard object you don't otherwise use, and document that decision.

A closer look

Tell us what you’re moving.

Share your source, destination and rough record counts. We scope the migration and the process work with you and send you a quote.

Get a quote