Associations represent the relationships between objects in the HubSpot CRM (contacts, companies, deals, quotes, line items, and tickets). The CRM associations endpoints help manage and define those relationships, allowing you to create a more holistic picture of your customer interactions and improving your ability to market, sell, and serve. 

Example use case: Your organization has several deals open with a company. Your sales team can use the CRM Associations API to associate these deals with a contact who has decision-making power. Associations also make it easier to analyze data and trends, like which job titles are most often connected with buying decisions.

Unsupported associations

This beta doesn't support the following associations:

  • Parent-child associations
  • Special contact-to-company associations
  • Engagements

However, you can still use these associations with the previous version of the API.

Association definitions

Associations are defined by object types and direction. Association definitions are unidirectional, so you'll use a different definition depending on the starting object type. 

For example, if you want to see tickets associated with a contact (identified by its objectId), you would define the association like this:/crm/v3/associations/contact/ticket/batch/read.

You can test your own examples in the Endpoints tab.