# HubSpot Setup Guide

## Setup guide

Peaky integrates HubSpot contacts, deals, leads, pipelines, and owners with your company's financial planning workspace, which lets users:

* **Use HubSpot data in your financial models.** Financial models are usually static — Peaky makes them dynamic. The integration bridges the gap by pulling your HubSpot CRM metrics (open deals and pipeline value by stage, ARR/MRR, sales-cycle length, contacts by source, etc.) directly into your financial projections, so forecasts stay tied to what's actually happening in your pipeline.
* **Analyse all your operational data, including CRM data, using Peaky Agent.** Peaky's AI Agents seamlessly analyze and compare data across your entire tech stack — accounting, HR, payments, and your HubSpot CRM — so you can ask questions in plain English and get answers grounded in a unified view of your business.
* **Get a holistic view of all your operational data.** Peaky centralizes your operational data, including HubSpot CRM data, providing a high-level overview of your most critical KPIs and metrics (ARR, MRR, opportunities and pipeline value by stage, deals entering each stage, average sales cycle length, contacts by source, and more).


---

## Install the app

There is nothing to install inside HubSpot directly — you start the connection from inside Peaky, sign in to HubSpot when prompted, and HubSpot brings you back to Peaky once you've approved access.


1. Log in to Peaky at <https://eu.peaky.ai>.
2. Navigate to your company in the sidebar and open the **Integrations** page.

   ![](https://docs.peaky.ai/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzdiNTU2ZDk5LWIxMDQtNGRkNS1hNzQyLWMwOWJjMzQ2M2EzNS80YzM2MmJhOC1iZjgyLTRiZjktYmIzYy1iZDEwMTdiZDMyYmMvTW9ub3NuYXAgSW50ZWdyYXRpb25zIC0gUGVha3kgIFBlYWt5IDIwMjYtMDItMjMgMjEtMTQtNDgucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTMxMDYwMDAsImV4cCI6MTc5MzE5MjQwMH0.KlK3v5JdoHdN07L0oNCy_0qFwg_C7Z-x5psPXBxgRvo " =1473x854")
3. Locate the **Hubspot** card under the **CRM** category.

   ![](https://docs.peaky.ai/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzg2MTc4YjA4LTJjMzMtNGEzMi1iNDJiLWU2MDdlMGY2Mjk3ZC9iNGM1YzA1ZS03OTU1LTRmZWQtYmNhZS1jNWJjZjIxMzBjYjcvU2NyZWVuc2hvdCAyMDI2LTA1LTA4IGF0IDExLjQ0LjQxLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkzMTA2MDAwLCJleHAiOjE3OTMxOTI0MDB9.cR00iQvrTnYJ6lLrNSCR71kxnSpEqNIZbhLaqxTvoWE " =903x102")
4. Click **Connect**. You will be taken to HubSpot to sign in.
5. Sign in to HubSpot if you aren't already, and select the HubSpot account you want to connect to Peaky.

   *[Include a screenshot of the HubSpot account-selection screen here.]*
6. Click **Choose Account**.
7. Review the access Peaky is requesting. Peaky asks for **read-only** access to:
   * Your **contacts**, including their lifecycle stage and source
   * Your **deals**, including amounts, ARR/MRR, currency, and close dates
   * Your **leads**, including lead sources and pipeline stages
   * Your **deal owners**

   Peaky **does not** request permission to create, edit, or delete anything in HubSpot. Your HubSpot data is never modified by Peaky.

   ![](https://docs.peaky.ai/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzg2MTc4YjA4LTJjMzMtNGEzMi1iNDJiLWU2MDdlMGY2Mjk3ZC85ZjZlZTZhNC03OTg2LTQxNzItYjQzMS01YjQyNDRmMzhiYjEvU2NyZWVuc2hvdCAyMDI2LTA1LTA4IGF0IDExLjQ1LjQyLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkzMTA2MDAwLCJleHAiOjE3OTMxOTI0MDB9.uX3Qz0Z8assKjr1nECUOCy1qmT8h1yb_8uTckd7Eii4 " =1059x741")

   
8. Click **Connect app**.
9. You will be brought back to Peaky's **Integrations** page. The HubSpot card will be marked **Connected** and an initial sync will start automatically in the background.

   ![](https://docs.peaky.ai/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzg2MTc4YjA4LTJjMzMtNGEzMi1iNDJiLWU2MDdlMGY2Mjk3ZC80ZGJkYjk3MC1lN2ExLTQ2YTktYjQ5Ni0yMjE1MmVhZDE3MmYvU2NyZWVuc2hvdCAyMDI2LTA1LTA4IGF0IDExLjQ3LjM0LnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkzMTA2MDAwLCJleHAiOjE3OTMxOTI0MDB9.g-1ngmIU3kvD0NIrGRs6k86l0vcMBeGqW4ezmAt-4yM " =1257x807")

   


---

## Configure the app

The HubSpot integration is read-only and does not require field mapping — there is no two-way sync direction to configure and no HubSpot properties to map by hand. Peaky automatically reads the right HubSpot information (deal stage, pipeline, ARR, MRR, currency, exchange rate, deal owner, contact lifecycle stage and source, lead source, etc.) and turns it into structured CRM metrics scoped to the entity you connected.


1. In Peaky, navigate to **Company → Integrations**.
2. The HubSpot card, marked **Connected**, gives you a **Sync** button and a **more** menu (**...**):
   * **Sync** (refresh icon) — manually trigger a sync. A sync also runs automatically the first time you connect.
   * **Logs** (in the **...** menu) — open the sync history dialog to see when each sync ran, how many deals/contacts/leads/metrics were processed, and any errors.
   * **Remove** (in the **...** menu) — disconnect the HubSpot account from this entity (see *Disconnect the app* below).

   ![](https://docs.peaky.ai/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzg2MTc4YjA4LTJjMzMtNGEzMi1iNDJiLWU2MDdlMGY2Mjk3ZC9kNDE1ZmZjYy05ODY4LTQ4MTktODBhNS0xMzkxZWU1ZmIwMDYvU2NyZWVuc2hvdCAyMDI2LTA1LTA4IGF0IDExLjQ5LjAwLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkzMTA2MDAwLCJleHAiOjE3OTMxOTI0MDB9.j6BDKVMImn0BikJqKLe0u2s62QIA-ovU6NQMmUvxwE4 "left-50 =474x100")

   



3. Multi-entity setup: if your company is structured as multiple entities, connect HubSpot per entity that has its own pipeline. The sync is scoped to the entity you're on; your CRM metrics will be attributed to that entity's financial model.


---

## Use the app

Peaky automatically keeps your HubSpot CRM data synced into the entity's metrics store. **No manual configuration is required.** Once connected:

* Peaky reads through every HubSpot deal, contact, and lead and pulls the relevant information (deal name, stage, pipeline, amount, currency, exchange rate, ARR, MRR, owner, close date; contact lifecycle stage and analytics source; lead pipeline, stage, and source). It also reconstructs how long each deal spent in each pipeline stage.
* From that, Peaky builds structured CRM metrics:
  * **Opportunities** by pipeline and stage, **as of each month**
  * **Pipeline Value** by pipeline, stage, and currency, **as of each month**
  * **Pipeline Movements** — deals that **entered** a stage during the month, by pipeline and stage
  * **Contacts** by source
  * **ARR / MRR** by pipeline, stage, and currency
  * **Average Sales Cycle Length** by pipeline
  * **FX Rate** for non-default currencies
* Deals, contacts, and leads are also available as tables on the **Data** page, so you can build your own metrics on them — for example lead volume by source.
* These metrics are immediately available to:
  * Reference inside **driver formulas** in your Peaky financial model (so a forecast line like *New ARR* can be tied to the real HubSpot ARR for the corresponding period).
  * Power widgets on **Views**, and the drift checks behind **Signals**.
  * Be queried by the **Peaky Agent**, which can answer questions like *"How did our pipeline conversion change last quarter?"* or *"Which sales rep closed the most ARR in Q1 vs Q2?"* by combining HubSpot data with your accounting, HR, and other connected sources.

You can manually re-trigger a sync at any time by clicking the **Sync** button on the HubSpot card on the Integrations page. Use **Logs** in the card's **...** menu to confirm a sync completed and see how many records were processed.

 ![](https://docs.peaky.ai/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzg2MTc4YjA4LTJjMzMtNGEzMi1iNDJiLWU2MDdlMGY2Mjk3ZC8xY2ZiMGIwOC1hZjAzLTQwOWItOTBjYi04NzE2OGEzZWIxYzYvaHVic3BvdC0xLmpwZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkzMTA2MDAwLCJleHAiOjE3OTMxOTI0MDB9.kWF_7uIEp-sxqNtR4IcDw4CYANKZtDJvqe8C8XWLi84 " =1600x900")


---

## Disconnect the app

> **Note:** If you disconnect your HubSpot account from Peaky, no further HubSpot data will sync into Peaky and any financial-model drivers that reference HubSpot CRM metrics will stop receiving fresh values from HubSpot. Existing metric data already imported into Peaky will remain in your Peaky workspace until you re-sync or manually clear it. Peaky has read-only access to HubSpot, so disconnecting does not modify any data inside your HubSpot account.


1. Log in to Peaky.
2. Navigate to **Company → Integrations**.
3. Locate the **HubSpot** card, marked **Connected**. The search box finds it quickly.

   ![](https://docs.peaky.ai/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzg2MTc4YjA4LTJjMzMtNGEzMi1iNDJiLWU2MDdlMGY2Mjk3ZC84ZjNiMjBkYi0zMDZkLTQ3MzItOTVlNi1iNjkyNjYzN2NiMmIvU2NyZWVuc2hvdCAyMDI2LTA1LTA4IGF0IDExLjQ5LjAwLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkzMTA2MDAwLCJleHAiOjE3OTMxOTI0MDB9.cI0p_8SA1YCt-6kGRdsWI2et2OzEbjSIylVGBkhfm14 " =474x100")

   
4. Open the card's **more** menu (**...**) and choose **Remove**.
5. A confirmation toast will appear: *"Remove Hubspot? Your data will no longer sync."* Click **Yes, remove**.
6. The HubSpot card is no longer marked **Connected**. The integration is now disconnected and Peaky will no longer be able to access your HubSpot account.