# HubSpot

[HubSpot](https://www.hubspot.com/) is a leading marketing and sales platform that helps you track leads, as well as inbound marketing and sales. It offers state-of-the-art tools for efficient marketing, tracking sales, and offering better customer support.

This document guides you in setting up HubSpot as a source in RudderStack. Once configured, RudderStack automatically ingests your specified HubSpot data, which can then be routed to your data warehouse destination supported by RudderStack.

**All the Cloud Extract sources support sending data only to a data warehouse destination.**

## Getting Started

To set up HubSpot as a source on the RudderStack dashboard, follow these steps:

* Log into your [RudderStack dashboard](https://app.rudderlabs.com/signup?type=freetrial).

![Rudderstack dashboard](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-46bf03e91571b97599709f217b34eb4ca57fed0e%2F1%20\(15\)%20\(1\)%20\(1\).png?alt=media)

* Then, click on the **Directory** option on the left navigation bar and go to **Cloud Extract** under **Sources**.

![Directory](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-919fac1023a534f9bbff0e68189b6ad4bef2c7d2%2F2%20\(18\).png?alt=media)

* From the list of sources, click on **HubSpot**.
* Assign a name to your source, and click on **Next**.

![Hubspot](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-48236cd9e281a6568e3c61493ae34c20999909e0%2F3%20\(13\).png?alt=media)

### Specifying Connection Credentials

* Next, authenticate RudderStack with HubSpot by clicking on the **Connect with HubSpot** option, as shown:

![Google Analytics](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-2a56e537dc0a4bc4516235e5344ff150d2616196%2F4%20\(15\).png?alt=media)

If you've already configured HubSpot as a source before, you can choose the account visible under the **Use existing credentials** tab.

### Setting the Table Prefix, Run Frequency and Data Update Schedule

* Next, you will be required to set the **Table Prefix**. RudderStack will create a table in your warehouse with this prefix name and load all your HubSpot data into it.
* Also, set the **Run Frequency** to schedule the data import from your HubSpot account to RudderStack. Optionally, you can also specify the time when you want this synchronization to start, by choosing the time under the **Sync Starting At** option.

![Run Frequency](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-b9bd833fbef602ec32164412d633897273810457%2F5%20\(15\).png?alt=media)

### Selecting the Data to Import

* Finally, choose the HubSpot data that you wish to ingest via RudderStack. You can either select all the data, or choose specific HubSpot data attributes, as per your requirement.

![Hubspot Data to ingest](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-a8e90ee36d3af2ead237daefcc05ca1b4498513c%2F6%20\(14\).png?alt=media)

That's it! HubSpot is now successfully configured as a source on your RudderStack dashboard.

RudderStack will start ingesting data from HubSpot as per the specified frequency. You can further connect this source to your data warehouse by clicking on **Connect Destinations** or **Add Destination**, as shown:

![Connect Destinations](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-2803594c5360d60121ad14abe4dcbee134be1539%2F7%20\(9\).png?alt=media)

Use the **Connect Destinations** option if you have already configured a data warehouse destination in RudderStack. To configure a data warehouse destination from scratch, click on the **Add Destination** button.

## FAQs

#### How does RudderStack sync the HubSpot data?

* When RudderStack first connects to your HubSpot data source, it pulls all of your historical data.
* Then, it syncs the HubSpot data based on the specified on the **Run Frequency** set by you in the RudderStack dashboard. The default setting is set to 30 minutes.
* There may be instances where an incremental sync is not possible due to HubSpot's API limitations. In such cases, a full sync is done.

#### How does RudderStack handle custom HubSpot fields?

RudderStack creates a column for any custom HubSpot fields and syncs it to your warehouse destination accordingly.

#### Is it possible to have multiple Cloud Extract sources writing to the same schema?

Yes, it is.

We have implemented a feature wherein RudderStack associates a table prefix for every Cloud Extract source writing to a warehouse schema. This way, multiple Cloud Extract sources can write to the same schema with different table prefixes.

## Contact Us

If you come across any issues while configuring HubSpot as a source, you can [contact us](mailto:%20docs@rudderstack.com) or start a conversation in our [Slack](https://rudderstack.com/join-rudderstack-slack-community) community.