---
title: "Import HubSpot custom object records linked to companies"
description: "Custom objects need HubSpot Enterprise. Import them with a unique ID property and a company domain or Record ID in the same row. Steps and limits."
url: "https://flitstack.ai/answers/import-custom-object-records-hubspot-companies"
---

# 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.

![](https://flitstack.ai/images/authors/aditya-kumar.webp)By [Aditya Kumar](https://flitstack.ai/about/aditya-kumar) Updated November 5, 2026

[Ask us about your migration ](https://flitstack.ai/contact) [Read the full guide →](https://flitstack.ai/guides/hubspot-import)

## 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 ID | Name         | Status    | Renewal date | Company domain |
| --------- | ------------ | --------- | ------------ | -------------- |
| SUB-1001  | Gold plan    | Active    | 2027-03-01   | acme.com       |
| SUB-1002  | Add-on seats | Active    | 2027-03-01   | acme.com       |
| SUB-1003  | Starter plan | Cancelled | 2025-12-31   | globex.com     |

5. **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).
6. **Spot-check** a few companies to confirm the custom records show in the association card.

## What the native tools do / where they stop

| Tool                            | Custom objects                                                                                 |
| ------------------------------- | ---------------------------------------------------------------------------------------------- |
| Smart Transfer                  | ”The transfer of custom objects isn’t supported”                                               |
| Import tool                     | Supported in single- and multi-object imports; matches on Record ID or a unique-value property |
| HubSpot paid CRM Data Migration | Bronze: none; Silver: up to 2; Gold: up to 4                                                   |
| APIs                            | Full 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](https://flitstack.ai/guides/hubspot-import) or [HubSpot migrations](https://flitstack.ai/migrations/crm/hubspot).

![Aditya Kumar](https://flitstack.ai/images/authors/aditya-kumar.webp)

About the author

[Aditya Kumar](https://flitstack.ai/about/aditya-kumar)

Founder, FlitStack AI

Aditya Kumar is the founder of FlitStack AI and Jetstack AI, both built at Ambrstack. FlitStack AI migrates CRM and business data between platforms; Jetstack AI is the AI platform HubSpot partners and RevOps teams use to audit portals, build implementations and reuse their best setups across portals. He writes about CRM data, migrations, HubSpot architecture and automation from the work of building them.

[More from Aditya](https://flitstack.ai/about/aditya-kumar) [LinkedIn](https://www.linkedin.com/in/aditya-ambrstack/)

On this page

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.

## Related

### [What does the HubSpot importer keep, and what does it drop?](https://flitstack.ai/guides/hubspot-import)

[Read →](https://flitstack.ai/guides/hubspot-import)

### [Migrate to HubSpot](https://flitstack.ai/migrations/crm/hubspot)

[Read →](https://flitstack.ai/migrations/crm/hubspot)

### [Dynamics 365 to HubSpot migration](https://flitstack.ai/migrations/crm/dynamics-365-sales/to/hubspot)

[Read →](https://flitstack.ai/migrations/crm/dynamics-365-sales/to/hubspot)

### [Salesforce to HubSpot migration](https://flitstack.ai/migrations/crm/salesforce-sales-cloud/to/hubspot)

[Read →](https://flitstack.ai/migrations/crm/salesforce-sales-cloud/to/hubspot)

## Sources

1. [HubSpot: Create custom objects](https://knowledge.hubspot.com/object-settings/create-custom-objects)
2. [HubSpot: Import multiple objects](https://knowledge.hubspot.com/import-and-export/import-objects)
3. [HubSpot: Set up your import file](https://knowledge.hubspot.com/import-and-export/set-up-your-import-file)
4. [HubSpot Product and Services Catalog: Technical limits](https://legal.hubspot.com/hubspot-product-and-services-catalog/technical-limits)
5. [HubSpot: Transfer data using HubSpot Smart Transfer (custom objects not supported)](https://knowledge.hubspot.com/integrations/transfer-data-from-other-apps-using-hubspot-smart-transfer)

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](https://flitstack.ai/contact)
