Skip to content
Get a quote

How do I import association labels between contacts and companies in HubSpot?

Short answer

Create the labels first, then import. In Settings, add the contact-to-company labels (Super Admin; up to 50 per object pair). In your file, include an Association label column, mapped as Import As > Association label, and separate several labels with semicolons. Use "Primary" to set the primary company. Importing labels requires a Professional or Enterprise subscription.

By

Steps

  1. Check your subscription. Importing association labels requires Professional or Enterprise.
  2. Create the labels. Go to Settings > Objects > Contacts (or Companies) > Associations and create each label, for example “Billing contact”, “Decision maker” or “Former employee”. Only a Super Admin can do this, and each object pair takes up to 50 labels. HubSpot says plainly: “You must create the association labels in HubSpot prior to importing.”
  3. Build one row per pair.
Contact emailCompany domainAssociation label
[email protected]acme.comPrimary;Decision maker
[email protected]acme-holdings.comBoard member
[email protected]acme.comBilling contact
  1. Import multiple objects (contacts and companies in one file). Map the label column as Import As > Association label.
  2. Use “Primary” in the label column to set the primary company.
  3. Check a few records on both sides, contact and company, to confirm the labels.

What the native tool does / where it stops

NeedNativeGap
Label contact–company pairsYes, with a label columnLabels must already exist; Pro/Enterprise only
Several labels per pairYes, separated by semicolonsLabel text has to match exactly
Replace or remove labelsNo: imports only addUse the record UI or the associations API
Labels on custom objectsSame patternNeeds Enterprise for the custom objects

The rule that catches migrations is that imports only add labels. If a first import gets them wrong, a second import won’t fix them. It just adds more. Test on 20 pairs before running thousands.

Coming from Salesforce?

Salesforce Account Contact Relations, with their roles, are the usual source. Each relation becomes one row, each role becomes a label, and the IsDirect relation is usually the one that becomes “Primary”.

Where FlitStack AI fits

FlitStack AI’s data checks include association mapping. It creates the labels in HubSpot, then maps source roles to them and checks a sample before the full run. See the HubSpot import guide.

Questions, answered

A few useful answers.

Does importing a label replace existing labels?

No. HubSpot adds imported labels to any that are already there. To remove a label, edit the association or use the API.

How do I import one contact linked to three companies with different labels?

Use one row per contact–company pair: the contact's email, the company's domain or Record ID, and that pair's label or labels. Several rows for the same contact are fine.

Can I import labels on Starter?

No. HubSpot says a Professional or Enterprise subscription is required to import association labels.

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