CRM associations overview

The CRM Associations API is used to manage associations between objects in the HubSpot CRM. This includes the association between a contact and its company, between a company and a parent or child company, between deal and a company or contact, or between a ticket and a contact or company, as well as associations between engagements and other objects. A full list of supported associations is listed below.

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.

Association Type Definition ID
Contact to company 1
Company to contact 2
Deal to contact 3
Contact to deal 4
Deal to company 5
Company to deal 6
Company to engagement 7
Engagement to company 8
Contact to engagement 9
Engagement to contact 10
Deal to engagement 11
Engagement to deal 12
Parent company to child company 13
Child company to parent company 14
Contact to ticket 15
Ticket to contact 16
Ticket to engagement 17
Engagement to ticket 18
Deal to line item 19
Line item to deal 20
Company to ticket 25
Ticket to company 26
Deal to ticket 27
Ticket to deal 28

Note: The special contact <–> company associations below are currently in beta. These associations can be managed using the API, but the associations will not appear when viewing the records in HubSpot unless you are participating in the beta program.

Companies also support the special contact associations below:

Association Type Definition ID
Advisor to company 33
Company to advisor 34
Board member to company 35
Company to board member 36
Contractor to company 37
Company to contractor 38
Manager to company 39
Company to manager 40
Business owner to company 41
Company to business owner 42
Partner to company 43
Company to partner 44
Reseller to company 45
Company to reseller 46

Docs for this section or API