> For the complete documentation index, see [llms.txt](https://docs.ebbot.ai/ebbot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/hubspot-integration-in-automations/actions/get-object-associations.md).

# 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](/ebbot-docs/integrations/automations-integrations/integration-setup-guides/hubspot-integration-in-automations/troubleshooting.md) for request errors and retry behavior, or return to the [action catalog](/ebbot-docs/integrations/automations-integrations/integration-setup-guides/hubspot-integration-in-automations/actions.md).