> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cassidyai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Find associated HubSpot records

> Retrieve records associated with a source record in HubSpot.

The Find Associated HubSpot Records action retrieves records associated with a source record in HubSpot. Use it to access related contacts, deals, companies, or tickets within your Workflows — for example, finding all open deals linked to a specific contact.

<Info>
  This guide walks through an example Workflow that finds active deals associated with a meeting participant. The Workflow triggers when a meeting ends, looks up the contact by email, retrieves associated deals, and generates a follow-up summary.
</Info>

<Steps>
  <Step title="Add a Find Associated Records action">
    In the [Workflow builder](/workflows/building), click the **+** button between existing blocks. Select **Find Associated Records** from the action list.

    <Frame>
      <img src="https://mintcdn.com/cassidy/UO0c6HH8Ick4vNlS/images/reference/find-associated-hubspot-records-img-0.png?fit=max&auto=format&n=UO0c6HH8Ick4vNlS&q=85&s=eed393a15bed91a5900cb25cdc4c8092" alt="Selecting the Find Associated Records action from the action list" width="623" height="273" data-path="images/reference/find-associated-hubspot-records-img-0.png" />
    </Frame>
  </Step>

  <Step title="Connect your HubSpot account">
    If you haven't already, [connect your HubSpot account](/integrations/hubspot/overview) to Cassidy.

    <Frame>
      <img src="https://mintcdn.com/cassidy/UO0c6HH8Ick4vNlS/images/reference/find-associated-hubspot-records-img-1.png?fit=max&auto=format&n=UO0c6HH8Ick4vNlS&q=85&s=f27e6a09b3f77f8652dc23b7ee40aa7e" alt="HubSpot connection prompt in the action configuration" width="624" height="793" data-path="images/reference/find-associated-hubspot-records-img-1.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/UO0c6HH8Ick4vNlS/images/reference/find-associated-hubspot-records-img-2.png?fit=max&auto=format&n=UO0c6HH8Ick4vNlS&q=85&s=d6df16e1d0847090b93092a8d3de8d73" alt="HubSpot account successfully connected" width="536" height="864" data-path="images/reference/find-associated-hubspot-records-img-2.png" />
    </Frame>
  </Step>

  <Step title="Rename the action (optional)">
    Enter a more descriptive name to make the action easier to reference as a variable later.

    <Frame>
      <img src="https://mintcdn.com/cassidy/UO0c6HH8Ick4vNlS/images/reference/find-associated-hubspot-records-img-3.png?fit=max&auto=format&n=UO0c6HH8Ick4vNlS&q=85&s=f23756a1df0230a3f09f23b9e7161d34" alt="Renaming the Find Associated Records action" width="507" height="120" data-path="images/reference/find-associated-hubspot-records-img-3.png" />
    </Frame>
  </Step>

  <Step title="Set up preceding actions">
    Before configuring the Find Associated Records action, add the necessary preceding actions. For example:

    * **Add a trigger** such as a **Meeting Ended** trigger.

    <Frame>
      <img src="https://mintcdn.com/cassidy/UO0c6HH8Ick4vNlS/images/reference/find-associated-hubspot-records-img-4.png?fit=max&auto=format&n=UO0c6HH8Ick4vNlS&q=85&s=5659052fb985d4fe9b90e976aebeede7" alt="Meeting Ended trigger configuration" width="460" height="529" data-path="images/reference/find-associated-hubspot-records-img-4.png" />
    </Frame>

    * **Add a [Look Up HubSpot Record](/integrations/hubspot/look-up-record) action** to find the contact by email from the trigger.

    <Frame>
      <img src="https://mintcdn.com/cassidy/UO0c6HH8Ick4vNlS/images/reference/find-associated-hubspot-records-img-5.png?fit=max&auto=format&n=UO0c6HH8Ick4vNlS&q=85&s=c8ddca195dff075a38289697f9a944db" alt="Look Up HubSpot Record action to find a contact by email" width="624" height="272" data-path="images/reference/find-associated-hubspot-records-img-5.png" />
    </Frame>
  </Step>

  <Step title="Select the source object type">
    Choose the HubSpot object type of the source record: **Contacts**, **Companies**, **Deals**, or **Tickets**.

    <Frame>
      <img src="https://mintcdn.com/cassidy/UO0c6HH8Ick4vNlS/images/reference/find-associated-hubspot-records-img-6.png?fit=max&auto=format&n=UO0c6HH8Ick4vNlS&q=85&s=3ea385449400b0760c6a4c757579ba72" alt="Selecting the source object type" width="624" height="301" data-path="images/reference/find-associated-hubspot-records-img-6.png" />
    </Frame>
  </Step>

  <Step title="Enter the source object ID">
    Provide the ID of the source record. Type the ID directly or press **#** to reference a variable from a previous step or trigger.

    <Frame>
      <img src="https://mintcdn.com/cassidy/UO0c6HH8Ick4vNlS/images/reference/find-associated-hubspot-records-img-7.png?fit=max&auto=format&n=UO0c6HH8Ick4vNlS&q=85&s=9ce064d88eccae8ac12235aa26192b6a" alt="Entering the source object ID using a variable reference" width="461" height="131" data-path="images/reference/find-associated-hubspot-records-img-7.png" />
    </Frame>
  </Step>

  <Step title="Select the associated object type (optional)">
    Choose the type of associated records to find: **Deals**, **Contacts**, **Companies**, or **Tickets**. If left blank, all associated records are returned.

    <Frame>
      <img src="https://mintcdn.com/cassidy/UO0c6HH8Ick4vNlS/images/reference/find-associated-hubspot-records-img-8.png?fit=max&auto=format&n=UO0c6HH8Ick4vNlS&q=85&s=5828a794077b40b2cb6dfaefade07f90" alt="Selecting the associated object type" width="473" height="351" data-path="images/reference/find-associated-hubspot-records-img-8.png" />
    </Frame>
  </Step>

  <Step title="Select the association type (optional)">
    Specify the type of association to filter by, such as `contact_to_deal` or `deal_to_company`. This narrows down the specific relationship between records.

    <Frame>
      <img src="https://mintcdn.com/cassidy/UO0c6HH8Ick4vNlS/images/reference/find-associated-hubspot-records-img-9.png?fit=max&auto=format&n=UO0c6HH8Ick4vNlS&q=85&s=e9aaae345b9d682ceb80759935589ce1" alt="Selecting the association type to filter results" width="471" height="117" data-path="images/reference/find-associated-hubspot-records-img-9.png" />
    </Frame>
  </Step>

  <Step title="Toggle return single record (optional)">
    Enable **Return Single Record** if you only want one associated record returned. When multiple records match, the action returns the first one.

    <Frame>
      <img src="https://mintcdn.com/cassidy/UO0c6HH8Ick4vNlS/images/reference/find-associated-hubspot-records-img-10.png?fit=max&auto=format&n=UO0c6HH8Ick4vNlS&q=85&s=c828bfca10b42cb6bb02357b115464c7" alt="Toggle to return only a single associated record" width="480" height="100" data-path="images/reference/find-associated-hubspot-records-img-10.png" />
    </Frame>
  </Step>

  <Step title="Add filters (optional)">
    Click **Add Condition** to filter associated records by specific criteria. Select a field, choose an operation (equals, contains, etc.), and enter the value. You can add multiple conditions using **AND** or **OR** operators.

    <Frame>
      <img src="https://mintcdn.com/cassidy/UO0c6HH8Ick4vNlS/images/reference/find-associated-hubspot-records-img-11.png?fit=max&auto=format&n=UO0c6HH8Ick4vNlS&q=85&s=f663aec69d1d194b4aa3aad81b0051f9" alt="Adding filter conditions to narrow associated records" width="475" height="205" data-path="images/reference/find-associated-hubspot-records-img-11.png" />
    </Frame>
  </Step>

  <Step title="Add a follow-up action (optional)">
    After retrieving associated records, you can add a [Generate Text](/reference/actions/generate-text) action to create summaries or follow-up content using the record data.

    <Frame>
      <img src="https://mintcdn.com/cassidy/UO0c6HH8Ick4vNlS/images/reference/find-associated-hubspot-records-img-12.png?fit=max&auto=format&n=UO0c6HH8Ick4vNlS&q=85&s=ee4fff6561d8a274716c52977b9eaa2c" alt="Generate Text action using associated record data" width="624" height="298" data-path="images/reference/find-associated-hubspot-records-img-12.png" />
    </Frame>
  </Step>

  <Step title="Publish and run the Workflow">
    The action returns the associated record(s) with their properties, which you can reference in subsequent Workflow steps.

    <Frame>
      <img src="https://mintcdn.com/cassidy/UO0c6HH8Ick4vNlS/images/reference/find-associated-hubspot-records-img-13.png?fit=max&auto=format&n=UO0c6HH8Ick4vNlS&q=85&s=ea4f46f9ecd791476df6f1d498b21eb9" alt="Workflow output showing retrieved associated records" width="1026" height="1178" data-path="images/reference/find-associated-hubspot-records-img-13.png" />
    </Frame>
  </Step>
</Steps>

## Related

* [Create HubSpot Association](/integrations/hubspot/create-association)
* [Remove HubSpot Association](/integrations/hubspot/remove-association)
* [Look Up HubSpot Record](/integrations/hubspot/look-up-record)
* [HubSpot for Workflows](/integrations/hubspot/workflows)
