Get Object Associations

Fetches a HubSpot record with all of its fields, together with the other records it is connected to (for example the deals and contacts linked to a company).

Action identifier: get_object_associations. Reference checked: 29 September 2026.

Inputs

Field	Type	Required/default	Meaning
object_type	string	Required	The type of object (e.g. 'tickets', 'deals', 'contacts', 'companies')
object_id	string	Required	The ID of the object
associations	list[string]	[]	List of object types to fetch associations for (e.g. ['deals', 'contacts'])

Output shape

Paths are relative to this action's output. Select them from the builder's variable picker; do not add a ticket wrapper to actions that return top-level fields. Nullable property fields and empty defaults are not proof that a value was retrieved.

Path	Type	Meaning
id	string	HubSpot record ID.
properties	object	Property values returned for this record; some declared fields may be empty.
properties.subject	string | null	The subject of the ticket
properties.content	string | null	The content of the ticket
properties.hs_pipeline	string | null	The pipeline ID
properties.hs_pipeline_stage	string | null	The pipeline stage ID
properties.hs_ticket_priority	string | null	The priority of the ticket
properties.firstname	string | null	First name of the contact
properties.lastname	string | null	Last name of the contact
properties.email	string | null	Email address of the contact
properties.phone	string | null	Phone number
properties.name	string | null	Name of the company
properties.domain	string | null	Domain name of the company
properties.dealname	string | null	Name of the deal
properties.amount	string | null	Amount of the deal
properties.dealstage	string | null	Stage of the deal
associations	dict[string, Any]	Linked record IDs and association types, grouped by requested target object type. Failed association reads can be omitted.
createdAt	string	Creation timestamp returned by HubSpot; empty when unavailable.
updatedAt	string	Last-update timestamp returned by HubSpot; empty when unavailable.
archived	boolean	Archive flag returned by HubSpot; defaults to false when omitted.
exists	boolean	True when the primary record is returned, even if an individual association read fails.

Open property/record objects may include additional HubSpot fields. Inspect the returned data rather than assuming every declared field is populated.

Behavior and limits

Looks up property definitions, requests those properties from the record, and reads each requested association type. Properties and associations are top-level outputs here; there is no ticket wrapper.

Association results contain linked IDs and type information, not the full linked records. Missing labels are filled from known association labels or Unknown. The action does not traverse further association pages.

If one association request raises an HTTP error, that association type is skipped while the rest of the record can still return with exists: true. Therefore a missing association section is not proof that no relationship exists. A missing primary record gives exists: false.

See Troubleshooting for request errors and retry behavior, or return to the action catalog.