The CRM Associations API helps manage and define relationships between objects in the HubSpot CRM (contacts, companies, deals, quotes, line items, and tickets), allowing you to create a more holistic picture of your customer interactions and improving your ability to market, sell, and serve. While a full list of supported associations can be found below, common examples include: contact to company, company to parent or child company, deal to company or contact, and ticket to contact or company. Associations can also be created between engagements and other objects. 

Use case for this API: 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.

Association definitions

Associations are defined based on the type of objects being associated, and the direction of that association. Association definitions are unidirectional, so you'll use a different definition ID depending on which object type you're starting with. For example, if you have a contact (identified by its vid) and you want the associated tickets, you would use definition ID 15. If you have a ticket (identified by its objectId) and you want the associated contacts, you would use definition ID 16. See the table below for the full list of definition IDs.