Steps
- Check your subscription. Importing association labels requires Professional or Enterprise.
- 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.”
- Build one row per pair.
| Contact email | Company domain | Association label |
|---|---|---|
| [email protected] | acme.com | Primary;Decision maker |
| [email protected] | acme-holdings.com | Board member |
| [email protected] | acme.com | Billing contact |
- Import multiple objects (contacts and companies in one file). Map the label column as Import As > Association label.
- Use “Primary” in the label column to set the primary company.
- Check a few records on both sides, contact and company, to confirm the labels.
What the native tool does / where it stops
| Need | Native | Gap |
|---|---|---|
| Label contact–company pairs | Yes, with a label column | Labels must already exist; Pro/Enterprise only |
| Several labels per pair | Yes, separated by semicolons | Label text has to match exactly |
| Replace or remove labels | No: imports only add | Use the record UI or the associations API |
| Labels on custom objects | Same pattern | Needs 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.