> For the complete documentation index, see [llms.txt](https://docs.jetadmin.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jetadmin.io/getting-started/migrating-a-project/hubspot.md).

# HubSpot

Connect HubSpot to Jet Admin with OAuth and build apps on your Contacts, Companies, Deals and Tickets.

Use Jet Admin with your HubSpot portal to build renewal dashboards, support queues, or customer portals that expose only the parts of HubSpot your users need.

{% hint style="success" %}
Authorize Jet Admin through OAuth inside HubSpot. You can revoke access there at any time, and you don't need to copy or rotate a token.
{% endhint %}

## What you get

Jet syncs the following HubSpot objects:

* Contacts
* Companies
* Deals
* Tickets

HubSpot associations become relationships in Jet Admin, so a Deal resolves to its Company.

## Before you start

* A HubSpot account that can see the objects you need. Jet Admin inherits that user's visibility.
* Permission to authorize third-party apps in your HubSpot portal

## Connect HubSpot

{% stepper %}
{% step %}

#### Add HubSpot as a resource

In Jet Admin, open **Data → Add Resource** and select **HubSpot**. You can also add it while creating a new project.
{% endstep %}

{% step %}

#### Authorize access

Complete the HubSpot authorization prompt. Sign in with an account that can see everything your app needs.
{% endstep %}

{% step %}

#### Choose your connection mode

Choose **Sync** to blend HubSpot with other sources. Choose **Direct** for live two-way edits, so editing a Deal in your app changes it in HubSpot.
{% endstep %}

{% step %}

#### Sync the structure

Click **More → Sync Structure**. Contacts, Companies, Deals and Tickets appear in the Data Editor.
{% endstep %}

{% step %}

#### Verify associations

Confirm Deals resolve to the right Companies before building views that depend on the relationship.
{% endstep %}
{% endstepper %}

## Troubleshooting

Some objects are missing. Confirm the authorizing HubSpot user can see them. Jet Admin inherits that user's visibility. Only the four objects listed above are part of the standard sync.

Authorization fails. Your HubSpot role may not allow authorizing third-party apps. Ask a portal admin to complete the connection.

Deals aren't linked to Companies. The association exists in HubSpot but the structure sync predates it. Run **More → Sync Structure** again.

{% content-ref url="<https://docs.jetadmin.io/getting-started/migrating-a-project>" %}
<https://docs.jetadmin.io/getting-started/migrating-a-project>
{% endcontent-ref %}


---

# 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.jetadmin.io/getting-started/migrating-a-project/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.