Associate records

In HubSpot, there are standard CRM objects: contacts, companies, deals, and tickets. If your account has an Enterprise subscription, you can also create custom objects. To keep track of the relationships between these objects, you can associate their records together. Associations are always two-way (i.e., if record A is associated to record B, record B is also associated to record A) and can be viewed in each record in the right sidebar.

Examples of when you'd associate records include:

• When making a sale, you communicate via email to three individuals at the same company. In HubSpot, you associate the deal to the three contact records and their company record.
• When handling a customer complaint, you communicate via email to two individuals. These individuals are also in the middle of a sale with your company. In HubSpot, you can associate the ticket record to the two contact records and the deal record.
• A contact is an advisor at one company and an employee at another company. In HubSpot, you can associate the contact with both companies. You can set the employer as their primary company, and if you're in a Professional or Enterprise account, you can label them as an advisor for the other company.

You can also associate the activities in a record's timeline to appear in another record. If the records are already associated together, some activities will automatically be associated to the associated records. If you're using a mobile device, learn how to manage associations in the HubSpot mobile app.

Please note: the number of associations per record depends on the object and your HubSpot subscription.

Add associations on an individual record

To add associations to a record:

• Navigate to your records:
• Contacts: In your HubSpot account, navigate to Contacts > Contacts.
• Companies: In your HubSpot account, navigate to Contacts > Companies.
• Deals: In your HubSpot account, navigate to Sales > Deals.
• Tickets: In your HubSpot account, navigate to Service > Tickets.
• Custom objects: In your HubSpot account, navigate to Contacts > [Custom object]. If your account has more than one custom object, hover over Custom Objects, then select the custom object you want to view.

• Click the name of the record for which you want to add associations.
• In the right panel, locate the relevant object section and click Add. For example, if you want to associate a deal with the record you're in, look for the Deals section and click Add. You can either create a new record to associate to the record, or associate an existing record to the record.

• To create a new record to associate, on the Create new tab, enter information in the fields, then click Create. You can click Create and add another to create and associate this record, and begin creating and associating another.
• To associate an existing record, on the Add existing tab, search for the record you want to associate, and select the checkboxes next to the records in the search results. You'll also have recommendations based on common associations and properties like name, email address, and company domain.
  

• • If you're associating multiple or any additional existing companies to a record, you can do one of the following:

• • • To set the primary company, select Set as [record]'s primary company under the company you want to be primary. Learn more about how the primary company is set and used.
    • To replace the existing primary company with a company you're associating, select the Replace [company] as [record]'s current primary checkbox. The previous primary company will still be associated with the record, but will no longer be labeled as primary.

• • If you want to label this association (Professional and Enterprise only), click +Add association label. In the dropdown menu, select an appropriate label. If no existing labels accurately describe the relationship between the record and the company, click Manage association labels to create a new label.
  • Click Save.

Edit or remove associations on a record

To update or remove an association:

• Navigate to your records:
• Contacts: In your HubSpot account, navigate to Contacts > Contacts.
• Companies: In your HubSpot account, navigate to Contacts > Companies.
• Deals: In your HubSpot account, navigate to Sales > Deals.
• Tickets: In your HubSpot account, navigate to Service > Tickets.
• Custom objects: In your HubSpot account, navigate to Contacts > [Custom object]. If your account has more than one custom object, hover over Custom Objects, then select the custom object you want to view.
• Click the name of the record for which you want to edit associations.
• In the right panel of the record, hover over the association card, then click More:

• • Set as primary (Companies only): for associated companies, select to make the company association primary. In the dialog box, select the checkbox if you're replacing another company, then click Update. 
  • Remove as primary (Companies only): select to remove the company association as primary. To select a new primary company, in the dialog box, click the dropdown menu and select the company, then click Update. The original primary company will still be associated to the record, but will no longer be labeled as primary.

Please note: for contact records, a primary company association is required. If a contact has multiple associated companies and you remove one company as primary, you must select another primary company. If a contact has only one associated company, that company is primary by default and you cannot remove the primary label.

• • Edit association labels (Professional and Enterprise only): select to update the association label. In the dialog box, click the dropdown menu and select a new label or click x to remove a label. Click Update. You can also set association labels in bulk via import.
  • Remove association: select to remove the association. In the dialog box, click Remove association. If the association you’re removing is a primary company, use the dropdown menu to choose a new primary company.

Associate records in bulk

There are multiple ways to associate records in bulk:

• Associate records via an import, which includes the option to import association labels. The records in your import can be either new or existing records. Learn how HubSpot identifies and deduplicates existing records.
• Associate records via API. 
• Turn on the setting to automatically associate contact and company records based on the company domain.

View record associations on an index page

You can view associated records in bulk on each object's index page in the associated object columns. You can display columns for each association type (e.g., Deal → Companies) and for a record's primary company (e.g., Contact → Company (Primary)).

• Navigate to your records:
• Contacts: In your HubSpot account, navigate to Contacts > Contacts.
• Companies: In your HubSpot account, navigate to Contacts > Companies.

• Deals: In your HubSpot account, navigate to Sales > Deals.
• Tickets: In your HubSpot account, navigate to Service > Tickets.
• Custom objects: In your HubSpot account, navigate to Contacts > [Custom object]. If your account has more than one custom object, hover over Custom Objects, then select the custom object you want to view.

• To display associated records as columns in the table:
  • In the top right of the table, click Edit columns. 
  • In the dialog box, on the left, select the checkbox next to [Object] → [Objects] to display associations of that type. For example, if you're on the contacts index page, you could select Contact → Companies, Contact → Company (Primary), Contact → Deals, etc.
  • Click Apply. Learn more about customizing the table.
• In the columns:
  
  • [Object] → [Objects]: click the [x] records link to view all the record’s associations for that object. In the pop-up box, click the name to view the record.
  • [Object] → Company (Primary): on the contacts index page, click the name of the primary company to view the company record.

View a record's association history

You can view the history of a contact, company, ticket, and deal record's associations, including all associated records and engagements. You can also view when the records were originally associated and the source of the association.

• Navigate to your records:
• Contacts: In your HubSpot account, navigate to Contacts > Contacts.
• Companies: In your HubSpot account, navigate to Contacts > Companies.
• Deals: In your HubSpot account, navigate to Sales > Deals.
• Tickets: In your HubSpot account, navigate to Service > Tickets.
• Click the name of a record.
• In the left panel, click Actions, then select View association history.

• In the Select an object dropdown menu, select an object or engagement to view which records or activities of that type have been associated with the record.
• In the table, you can view the name of each associated record or activity, its Object ID, how it was updated (either Created or Removed), and the date and time of the update. You can also view the source of the update, which will be one of the following: 
  • User: the association was manually updated by a user. The source will include the user's name, or if unknown, the user ID.
  • Object deletion: the association was updated because the record or activity was deleted.
  • Object merge: the association was updated as a result of merged records.
  • Object restore: the association was updated as a result of a restored record.
  • Import: the association was updated via an import.
  • Auto association by domain: for contacts and companies, the association was updated automatically by HubSpot based on the company domain. 
  • API: the association was updated via API.
  • Job: the association was updated via internal automation.
  • Migration: the association was updated via a data migration.
  • Unknown: the source of the association could not be determined.

• To copy a link to a record or engagement in the table, hover over the association, then click the duplicate copy icon.
• To view the entire history of a specific association, hover over the record or engagement, then click View history. In the right panel, view the details of each update to the association with your record, sorted from most recent to oldest.