# HubSpot

HubSpot provides multiple ways to integrate functionality with their system, including API keys, Ecommerce Bridge and Private Apps. The following instructions show how to integrate with HubSpot using Private Apps (which replace API keys).

## Account integration using Private Apps <a href="#sb2joe88ievk" id="sb2joe88ievk"></a>

To begin, you will need:

* A HubSpot account.

**STEP 1:** In the top-right corner, go to your account's **\[Profile & Preferences]**.

![](/files/vEg60ryLcAJy7MjMRRjb)

**STEP 2:** In the left side-bar, go to **\[Account Setup] > \[Integrations] > \[Private Apps]**.

![](/files/JwhKZxJjW3irXv6EJkYF)

**STEP 3:** Create a new private app and fill in the name, logo and description for the app.

**STEP 4:** Select the scopes that are necessary for the required functionality. A full list of the scopes used by HubSpot-related nodes can be found [below](#hubspot-scopes).

![](/files/NuG2DwDyvLQf4p0dNo6y)

**STEP 5:** In the top-right corner, click **\[Create App]** to generate an **access token**. After creation, you can view and copy the token.

![](/files/94ipOTNfX8cOOOaSb2aW)

**STEP 6:** In iMBrace, create a new credential of type **HubSpot App Token** and enter the access token. Then click **\[Submit]**.

![](/files/LDJmjoF8Ob6iA67I0L3m)

**DONE:** The credential can then be used for HubSpot nodes.

## HubSpot scopes

Credentials for HubSpot-related nodes should have the following scopes:

**HubSpot node:**

* `oauth`
* `crm.objects.companies.read`
* `crm.objects.companies.write`
* `crm.objects.contacts.read`
* `crm.objects.contacts.write`
* `crm.objects.deals.read`
* `crm.objects.deals.write`
* `crm.objects.owners.read`
* `crm.schemas.companies.read`
* `crm.schemas.contacts.read`
* `crm.schemas.deals.read`
* `forms`
* `tickets`

**HubSpot Trigger node:**

* `oauth`
* `crm.objects.companies.read`
* `crm.objects.contacts.read`
* `crm.objects.deals.read`
* `crm.schemas.companies.read`
* `crm.schemas.contacts.read`
* `crm.schemas.deals.read`


---

# Agent Instructions: 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:

```
GET https://imbrace.gitbook.io/imbrace-documentation/integrations/hubspot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.