HubSpot Association

Description

The HubSpot Association entity defines the relationships between different HubSpot records, such as linking a contact to a company, a deal to a contact, or a ticket to a company. Associations are essential for maintaining a connected data model and enabling contextual reporting and automation

The HubSpot Association activity enables creating, retrieving, and removing associations (relationships) between HubSpot CRM objects like Contacts, Companies, Deals, Tickets, and Engagements.

Use this activity to:

• Get – Fetch existing associations from a source object to a target object by specifying object IDs.
• Create – Establish new relationships between two HubSpot entities (e.g., link Contacts to Deals).
• Remove – Delete existing associations between objects in HubSpot.

Use Case: Automate the process of linking contacts to deals and companies in bulk when ingesting data from a CSV file, enabling seamless relationship management across HubSpot modules during lead onboarding workflows.

Input

Output

Output Type	Format	Description
Data	JSON	List of association responses (if any)

Configuration Fields

Field Name	Description
Connection	Select a HubSpot OAuth connection.
Operation	Choose from: Get Create Remove
From Object	Source object type (e.g., Companies, Deals, Contacts).
To Object	Target object type to associate with.
From Object Ids	List of source object IDs. Required for Get operation.
Association Type	Association definition configured in HubSpot (depends on object types). Required for Create/Remove
Associations	List of mappings between source and target object IDs. Used in Create and Remove.

Sample Input

Operation	Required Fields	Example Input
Get	FromObjectIds	FromObject: Companies ToObject: Deals FromObjectIds: [12345, 67890]
Create	AssociationType, Associations	FromObject: Contacts ToObject: Deals AssociationType: contact_to_deal Associations: [{Key: 111, Value: 222}]
Remove	AssociationType, Associations	Same as Create

Sample Configuration

Field	Value
connection.id	hubspot-conn-01
operation	Create
fromObject	Contacts
toObject	Deals
associationType	contact_to_deal
associations	111 → 222

Sample Output

FromObjectId	ToObjectId	Status
111	222	Created