> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/flow-studio/nodes/get-a-record-from-hubspot.md).

# Get a Record from Hubspot

A very important part of working with Data via API is to be able to search for an object inside your CRM remotely. At Dapta we have set a native connection with HubSpot that allows you to search different types of Data inside of HubSpot via its API. HubSpot’s API is very versatile so it allows you to search via multiple different parameters. By default, HubSpot has 3 main entities that can be searched. These are “Companies”, “Contacts” and “Deals”.

\
In Dapta, you can search each for each of the entities in HubSpot via the API. To do this, open your Flow Studio page and open a new Flow. Then go to the templates and select the “Search Record” node

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfVqAxG-uHzMD1Ibcq5S7GMy0vswjGIaSm2cQzAlT3_8nn4Pmrb1eSiowwJMTJFUQyKScreka8vZ83o13X1uqfdmJPLr7cJSDAOyscZSdNNTrVV758_AV3EMT-14VSl_eYQA1cLSQ?key=WOBNB_rJfOlCxAUb1kQyYCgN" alt=""><figcaption></figcaption></figure>

When you add this node you will have the option to select a Credential, which is your way of connecting to HubSpot via the API. If you need help setting up the credential got to this part of the documentation

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfrzQVzqJR8_cuyB3Pqd1iov5pspLhS0b9M1it4QMIbxsApES3MqSCOjE396jZf7wDTWSCvnQ096Uzp8vXWfp2uKJeS0-0Ck3JomcpKXGjW7XmUJ_yygtJOkUdN--LHehiUbKTGwQ?key=WOBNB_rJfOlCxAUb1kQyYCgN" alt=""><figcaption></figcaption></figure>

On this node you can select which type of entity you are going to query

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc7OdWvMr4XlOeu-19cO_n95lylTrpScSvJu-RMiy1-LgMdjTf_MzGgz7CbhR99eXlku6oRoWhsx8E_jnne0tbg2imUTYuerpyuDWd9qGgCuE381UHXSw3jDSlaxX91K1xhOW81Ew?key=WOBNB_rJfOlCxAUb1kQyYCgN" alt=""><figcaption></figcaption></figure>

Once you have selected the entity or object type, it’s really important to select which properties to extract. This is because each record in HubSpot has dozens of properties, and not all of them are relevant for querying. So you can just select which ones are relevant for you

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe274nGJ-djux42qqzYvW90hy2BtsU5b4dLDq9p7U2eFNazID1IWeSkRpRG7e3DLFwtswNJ8oU29QI-KUZSVP2Nkr4fTAphATALtzPLH4bh2_qIA_MZWC2Dwzh5wkZjSp8kuwci?key=WOBNB_rJfOlCxAUb1kQyYCgN" alt=""><figcaption></figcaption></figure>

After you have selected the properties to be shared, you can select which will be the filter to extract the information. The most recommended here would be either the HubSpot ID, email or the phone number (for contacts mainly).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfFTrgnP0OWHY1gVv9zGiBGDMgycY5BwgQBk1eSmqtX-KqmJQFi7wArSlp6mfZ6ktFXF-uutD3ycsCdqGtMR3ntFWak1-URuuZUUdi6jbZus_lfN5xGIVbz2qFcXD7I_xmHXyur6Q?key=WOBNB_rJfOlCxAUb1kQyYCgN" alt=""><figcaption></figcaption></figure>

And now, when you run the flow connected to the new node, you will receive the information related to the filter you set up

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdojZ4m8JQAWinNgOaknrh8cWboaQVbYQusHy-7fmLyvpy5igP1lh7gJZOl2A2cZtouibGoIAIx34FqFR_gw-RiM4medmnAbShOx86l6GS4S24AjUFOoXWqtSGYdFgS2KAgHu1A?key=WOBNB_rJfOlCxAUb1kQyYCgN" alt=""><figcaption></figcaption></figure>

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.dapta.ai/flow-studio/nodes/get-a-record-from-hubspot.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
