---
title: "Syncing in Hubspot"
description: "Integrating Hubspot with RentBamboo."
url: https://qdvyzaudc.gleap.help/en/articles/17-syncing-in-hubspot
collection: "Step 4: Syncing your Data"
updated: 2026-07-02
language: en
---

# Syncing in Hubspot

Integrating Hubspot with RentBamboo.

## Integrating Hubspot

**For PM company teams onboarding to RentBamboo.**

This guide explains every part of the HubSpot sync - what it does, how to set it up, and what to do when something breaks.

**RentBamboo uses the term "Lead," while HubSpot uses "Contact." In this guide, these terms refer to the same entity.**

* * *

## **What This Integration Does**

HubSpot sync moves leads between RentBamboo and HubSpot CRM in both directions.

Direction

What happens

<table data-id="4c0eb98c-e5b8-42ab-8911-8df8633753cd" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="37f7a321-3fb7-4ece-902b-1d591f8cdd00"><strong>Import</strong></p></td><td colspan="1" rowspan="1"><p data-id="8dc49eb6-8e70-4fb1-b017-e074ea0b2ac6">HubSpot contacts → RentBamboo leads</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="0dab72f5-d3b4-4220-b31d-b20163c5e328"><strong>Export</strong></p></td><td colspan="1" rowspan="1"><p data-id="4fb89dac-6db2-4b99-b641-3d651c413095">RentBamboo leads → HubSpot contacts</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="886c21ee-ffa2-439a-9488-38308150e519"><strong>Two-way sync</strong></p></td><td colspan="1" rowspan="1"><p data-id="b4e7c545-d444-431e-8588-571a5368808b">Changes in HubSpot update RB leads automatically via webhooks</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="88374c5c-7b7a-4cdc-98e6-6b29d4b19159"><strong>Auto-sync</strong></p></td><td colspan="1" rowspan="1"><p data-id="4c5020a3-0714-49e1-a052-2ad86081f6e7">Scheduled polling sync on a configurable interval</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="e9f1b6fb-a170-4292-9af4-666da400a9b1"></p></td><td colspan="1" rowspan="1"><p data-id="bfcfe2c5-59ca-4677-9ede-cc7ba32fae6d"></p></td></tr></tbody></table>

* * *

## **Architecture: Each Team Brings Their Own App**

**This is the most important concept - read it twice.**

RentBamboo does NOT use a shared HubSpot app. Every team must create their own HubSpot app and provide four credentials. This means:

-   Each team manages their own OAuth tokens
    
-   Each team has their own webhook subscriptions tied to their own app
    
-   One team's connection does not affect another team's connection
    
-   Data never flows through RentBamboo's infrastructure in the wrong direction
    

**The four credentials every team needs:**

Credential Found Where Notes

<table data-id="4c90c975-edf7-454f-91cc-a45e1800f0fc" style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="a4a77b75-fa99-47e8-9533-b18e5e8d933e"><code>clientId</code></p></td><td colspan="1" rowspan="1"><p data-id="27d6cec4-2ead-4ede-be66-52e20d782ade">Your HubSpot app settings</p></td><td colspan="1" rowspan="1"><p data-id="e024eab8-d668-4cc4-8102-f0f630c2c562">Public, safe to share</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="6f8addc8-fcc7-4bfa-a4cb-0a5c38465c4a"><code>clientSecret</code></p></td><td colspan="1" rowspan="1"><p data-id="aaf9d9fd-78c6-4df8-b79a-168c0de41ff6">Your HubSpot app settings</p></td><td colspan="1" rowspan="1"><p data-id="8a3fa339-7784-4ed7-8988-f44463205b69"><strong>Keep secret</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="8dba4be3-b4bf-4a66-b985-ec4f120d6a91"><code>appId</code></p></td><td colspan="1" rowspan="1"><p data-id="6808bb3a-59ae-4503-a928-db4f67310ea8">Your HubSpot app settings</p></td><td colspan="1" rowspan="1"><p data-id="bded8bb5-cef1-442a-ad92-89ea3327e133">Numeric ID (e.g.&nbsp;<code>987654</code>)</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="f83c06b5-b7ac-4e4f-b192-8289cf8db577"><code>developerApiKey</code></p></td><td colspan="1" rowspan="1"><p data-id="cdc740ab-f4c7-4314-ad8c-1165ad649db1"><strong>Keep secret</strong>&nbsp;- different from clientSecret</p></td><td colspan="1" rowspan="1"><p data-id="f870af13-61eb-4ec9-ad36-098a5f75b94b"></p></td></tr></tbody></table>

> ⚠ The `developerApiKey` (hapikey) is used exclusively for webhook management. It is NOT the same as your OAuth client secret. This is the main for sync.
> 
> **To make this setup 10x simple, follow the steps below.**

* * *

## **Setting Up Your HubSpot App (Step by Step)**

### **Step 1 - Create a HubSpot Developer Account**

If you have an existing HubSpot account, you might be familiar with this developer option on your left, **click it**

![](https://staticfiles.gleap.io/ghelparticle/EFGU7MYLQufpb85xZ9nKgvLonSAhtfWLZtr1rPtqaqIq5Y6ErM2wxEJDcMrVEwwzW3jd7VDWZ4d.png)

If you don't already have one:

1.  Go to [developers.hubspot.com](https://developers.hubspot.com/)
    
2.  Sign up / log in
    
3.  You need a **Developer Portal** (separate from your CRM portal)
    

* * *

### **Step 2 - Create a New App**

![](https://staticfiles.gleap.io/ghelparticle/x5RsfNYrbGxH28Rc4Uoibq0Byn76tfRA2tYORJj4FvChetNb2Ltbc4v740eOReykD7y4cg9VNY0.png)

1.  In your Developer Portal, go to **Legacy Apps** and click **Create legacy app**
    
    ![](https://staticfiles.gleap.io/ghelparticle/bPppvPO6puccA0NH1GhUDfmPOrOvKwKFWOTnHlQm5ok1nRwhUdWbDW3KFPBqukwF4YXbjQSn5ee.png)
    
2.  Choose the **Public** option
    
    ![](https://staticfiles.gleap.io/ghelparticle/x5RsfNYrbGxH28Rc4Uoibq0Byn76tfRA2tYORJj4FvChetNb2Ltbc4v740eOReykD7y4cg9VNY0.png)
    
3.  Give it a name like "RentBamboo" or "Rentbamboo - \[Your Company\]" and leave the description blank or write something simple
    
    ![](https://staticfiles.gleap.io/ghelparticle/ASpZyEaP2YRkrMsrELP3WM8CFyXZKwoJzAyVFxuIpUjSNeDjiWeyT8Q49sJq1OeHnwhFrPDoIYB.png)
    
4.  Next, click on the **Auth** tab.
    
    ![](https://staticfiles.gleap.io/ghelparticle/4p5CSMXUWicP6zfBaQAOIqVvUnuCYC5i0CyZr5lZfFzaXp5XzNgvHrCkBbYNDwocZtfHDccnYDs.png)
    
5.  Scroll down the **Auth** tab to find **Redirect URL**, and set the URL to: [https://www.rentbamboo.com/api/hubspot/callback](https://www.rentbamboo.com/api/hubspot/callback)
    
    ![](https://staticfiles.gleap.io/ghelparticle/tWWW19AQcjtzMijFJtFGBagpw5h18V0wPP3FgqVgNsYVNe4ui5hsLIrewipqhQHyFjRTHHY7jAe.png)
    
6.  Once entered successfully, click on the **Create app** button.
    

* * *

### **Step 3 - Configure OAuth Scopes**

Your app needs specific OAuth scopes to do its job. In your app settings:

1.  Navigate to **Auth** tab → **OAuth scopes** and click on **Add a scope** button
    
    ![](https://staticfiles.gleap.io/ghelparticle/DzIjXcMs56NnbdUkfoyC9dCg0PEjFAk0JAUBE4ZPSyQmct91tFyGva2nSEn1fHsDaVkWEnj1i5e.png)
    
2.  Add these scopes (Search and add them one by one, **Oauth** scope is added by default):
    

```javascript
oauth

crm.objects.contacts.read
crm.objects.contacts.write
crm.objects.owners.read
crm.lists.read
crm.lists.write
crm.schemas.contacts.write
sales-email-read
```

![](https://staticfiles.gleap.io/ghelparticle/EnY98GFvNDHDbSLSrgzaXapCsxLrqRfrASoYMXlCT3DhEXHNJ4OzuNhXg4dTbxvOuZI5RuQxjDg.png)

### **Step 4 - Note Your App Credentials**

In your app settings, find and copy:

-   **Client ID** - public, paste into RentBamboo settings
    
-   **Client Secret** - private, paste into RentBamboo settings
    
-   **App ID** - numeric, paste into RentBamboo settings (this is different from Client ID)
    

![](https://staticfiles.gleap.io/ghelparticle/8o67m46M3TrYAdfBJyVGIdwOMiiK6BmV8dMoljCdOOOTtEdKkeZ7ve1tZ9nUnZw9ecvJwxWwPD1.png)

### **Step 5 - Get Your Developer API Key**

1.  Click on the developer button and navigate to **Keys** -> **Developer API Key**
    
2.  Click Show and this is your `developerApiKey`. Copy it.
    
    ![](https://staticfiles.gleap.io/ghelparticle/9ldQrBQUTEQ9Nqh9XvMTc7kaHv4hak3cwP44LGupNf3LiQlxPY14qaGXfjP8MctmRBTDJU3oF2P.png)
    
    ⚠ Developer API keys are tied to your **Developer Portal account**, not your CRM portal. You need the hapikey from the developer account that owns the app, not from the CRM portal you're connecting to.
    

* * *

## **Step 6 - Connecting HubSpot in RentBamboo**

### **Prerequisites**

-   You must be a **team Admin or Owner** in RentBamboo
    
-   You must have your four HubSpot credentials ready
    

### **Steps**

1.  Go to **Dashboard** → **Settings** → **Integrations**
    
2.  Click on the _Connect_ button on the **HubSpot** Integration screen.
    
    ![](https://staticfiles.gleap.io/ghelparticle/h9ddtHEMjffsROh4u7jraVRe7iPIRWDHbEgVc1ogVLas0OFypBX6pfOg9zuiTO7vTqnSnYqTtXn.png)
    
3.  In the **Credentials** section, enter:
    
    -   **Client ID** - from your HubSpot app
        
    -   **Client Secret** - from your HubSpot app
        
    -   **App ID** - numeric, from your HubSpot app
        
    -   **Developer API Key** - from your HubSpot developer portal
        
        ![](https://staticfiles.gleap.io/ghelparticle/zl6IWW3qzAX5Wa5MxmrXdCyysMSvvoCpyDYbDCPiOHX7yj9ZCW2D63R6ChOAm95Z8EKJzWq1bg6.png)
        
4.  Click on the **Save Credentials** button.
    
5.  Click **Connect to HubSpot**
    
    ![](https://staticfiles.gleap.io/ghelparticle/9HaKpmTnFJbyNn1JB39GtE1pr6MzdhHmzchieE2s2B3nyBNji96PNegjKjawyVEuFqoUI2tCIN7.png)
    
6.  You'll be redirected to HubSpot to authorize the app
    
7.  Click **Connect App** in the HubSpot consent screen and type **I accept the risk**.
    
    ![](https://staticfiles.gleap.io/ghelparticle/gsgs3wQfFPb7DiszzYyMmskYWLzg2Mvb6PkgXYu4KGfko1YfxE0offch5Y2dzuHON7GLTtvoxAH.png)
    
    ![](https://staticfiles.gleap.io/ghelparticle/zHgNu2AphQTyQ6CpHk9CS1rIsVSGINK1bJT0GbqHgojKs5VkFJX66Ij3joIE2HLOAJgbdCG88Th.png)
    
    ![](https://staticfiles.gleap.io/ghelparticle/eZdLHRQxoCrj4omfJxzU2lHIj7WbmmM7UjeCzDED9Cy0eprSEaxoBeHtzcxGNOfsiBOkezaPrIy.png)
    
8.  After you type and click **Connect**, You'll be redirected back to RentBamboo - you should see "Connected" status
    

![](https://staticfiles.gleap.io/ghelparticle/QFriR0y77ltZPeGBplI0kRe5pZ8y7CGkE8rXi2FNxMFBheAyZqsndF9KOnjDE2MtmM6trF3ddDg.png)

* * *

## **Step 7: Status Mappings (very important)**

**How to Set Up Mappings**

1.  On **RentBamboo**, Go to **Dashboard** → **Settings** → **Integrations** → **HubSpot**
    
2.  Scroll down to the **Status Mappings** section
    
3.  Click on **\+ Add** button, you will have 2 drop-downs appear on the left and right.  
    
    ![](https://staticfiles.gleap.io/gattachments/dnXki0yUeYRb8VjJhUrP3CkhWiOcSA7yFcz9RIn48TEPxLjwSx0q8X6CU68pG6hwOSbgERGIsqr.png)
    
4.  In the **left dropdown**, pick a **RentBamboo status→** In the **right dropdown**, pick a **HubSpot status**  
    
    ![](https://staticfiles.gleap.io/gattachments/wlx9cpnNw91GlcPsvowHULWhjyaULG8jwCHN8oXf5JJE2FaVwn6XNMyZHZmFJBwOaHswScd4NpC.png)
    
      
    
5.  Repeat for every status your team uses
    
6.  Any unmapped statuses will show a yellow warning banner - status sync will skip these until you map them or might cause errors. **So to be SAFE match every lead status you use on RentBamboo to a status on HubSpot, until you see a green sign saying “All lead statuses mapped”.**
    
7.  Click **Save Mappings** once done.  
    

For Example, here are my mappings (can differ):

![](https://staticfiles.gleap.io/gattachments/KdjSsmrd6FughnXG4Ru803ujugKjtQjJX5PIejXpoH6Av3j8n5l9G54iQSC6lsxKRZ4hrCEoqVW.png)

**BONUS: Setup Similar status as RentBamboo on HubSpot.**

1.  **Click on the three vertical dots** beside the Add contacts button  
    
    ![](https://staticfiles.gleap.io/gattachments/Cu74S1JdhLq6EG689omqYXNmLDBh524IYIiZzPHskpp4X0OxhlXEwM0ExjH2liit5h71N62d6Od.png)
    
2.  Click on **Edit Properties** option.
    
3.  You will go to the Properties page.  
    
    ![](https://staticfiles.gleap.io/gattachments/P46agYmKTzma0EAcoWTvRl7n19AWyw8IyTZZFNxdxhfUPAzV2Ql8fjn7cYWHOQgYRnneLNU5FFI.png)
    
4.  In the search bar, type **lead status**, and click on the first search result **Lead Status (radio select)**
    
5.  Click on **Field Type** on the left sidebar
    
6.  Scroll down to find your Lead Status choices available on HubSpot.
    

Here are mine :

![](https://staticfiles.gleap.io/gattachments/d90RV62GjmFIO1y5U0XPi5DJ5C2LWIfzOCxU2iIyBB367EteBDD7O32IgwdA3jfXzpx2DbGxb5f.png)

7.  Now, click the **\+ Add option** button on the bottom.
    
8.  Once clicked, you will be prompted to enter a **Label** and an **Internal Name**
    
9.  For Label you can enter **Interested** and for it’s internal name you can enter the same but lowercased and \_ for space… in my case just lowercase as it is one word - **interested**
    
10.  Now make sure **internal name is always lowercase**, **and for space between words add an underscore instead**. You can refer my radio options I have setup in the picture above.
     
11.  **(The internal names are capitals and native to HubSpot, so we don’t touch that)**
     
12.  So once setup, do not forget to click the **Orange Save Button on the top right of your screen**. (Do not forget this, or else HubSpot wont take your changes of options into effect.)
     

\- - -

Example for two words:  

![](https://staticfiles.gleap.io/gattachments/8GOsObVP4TNmsmXkwoEhDohtb6HMMDCKyaNXd3OE7UWCTGUUEZ5bPrewo9tAHS9PN7geZL0cgpP.png)

**  
Click on the Orange Save button on the top right, to save once done. (Do not forget)**

![](https://staticfiles.gleap.io/gattachments/idGM6KZKodY6ioZAoODMBAahJmrqOV6Szf20OEr5e9EffKwcECfwnVu67htUCXrQcX7DvJdXxNY.png)

7.  So now after setting it up, it is identical to RentBamboo’s statuses.  
    
    ![](https://staticfiles.gleap.io/gattachments/d90RV62GjmFIO1y5U0XPi5DJ5C2LWIfzOCxU2iIyBB367EteBDD7O32IgwdA3jfXzpx2DbGxb5f.png)
8.  Now I can go back to RentBamboo’s Status Mappings, and here’s how it looks - matched with the latest statuses we just made.  
      
    
    ![](https://staticfiles.gleap.io/gattachments/iBGYOZtEULCRNSyWgfDaGmqrY6WDvcKpUazLueSge9rLMILbj6dytdiaI5lscEpI64QpPQtJy7i.png)
    

Neat isn’t it?

* * *

## **Step 8: Owner Mapping (optional, but highly recommended)**

**If this is not configured, all leads will sync in both directions. HOWEVER, you'll have less control over lead ownership and assigned property owners in HubSpot, so this setup is highly recommended.**

![](https://staticfiles.gleap.io/gattachments/KLDZXmqDUDb2OFtq1HdvL44S12wPQehIB500ILHzBvGXFcydS7tXsuuBjEilJFztZ3sSRNOZVxe.png)

### **What it does:**

If your team manages multiple properties on the 1 HubSpot Contacts CRM, you map each RB team member to a HubSpot’ contact owner / assigned property owner. Only leads belonging to mapped owners sync. Unmapped owners’ leads stay in RB and never reach HubSpot.

### **How it works:**

\- When owner mappings are configured, **ONLY** **mapped leads sync both ways.**

\- When NO mappings exist (empty), ALL leads sync normally.

\- Owner changes flow both directions:

-   RentBamboo Lead Owner changes → HubSpot Contact Owner updates
    
-   HubSpot Contact Owner changes → RB Lead Owner updates
    

### **Setup:**

1\. Scroll to Owner Mapping section in HubSpot settings

2\. Click **\+ Add**

3\. **Left dropdown** → pick a **RentBamboo Lead Owner / Team Member**

4\. **Right dropdown** → pick the matching **HubSpot owner**

5\. Repeat for every lead owner / team member

6\. Click **Save** **Owner Mappings**

* * *

## **Importing Leads (contacts) from HubSpot (HubSpot → RentBamboo)**

This is a **manual, on-demand sync**. Use this to bring in existing HubSpot contacts as RentBamboo leads.

### **How it works**

1.  Click **Import from HubSpot** in the HubSpot settings page
    
2.  RentBamboo fetches all contacts from your HubSpot portal (paginated - handles thousands automatically)
    
3.  A preview modal shows all contacts with their name, email, phone, and HubSpot status
    
4.  You can select/deselect individual contacts
    
5.  Click **Import Selected** - contacts are upserted into RentBamboo:
    
    -   If a lead with the same email already exists → **updated** (not duplicated)
        
    -   If no match → **created as new**
        
6.  Each imported lead gets tagged `hubspot-import` and stamped with sync metadata
    

* * *

## **Exporting Leads to HubSpot (RentBamboo → HubSpot)**

Push RentBamboo leads to HubSpot as contacts. Also manual/on-demand.

### **How it works**

1.  Click **Export to HubSpot**
    
2.  A preview modal shows all team leads
    
3.  Select the leads you want to export
    
4.  Click **Export Selected**
    
5.  Leads are upserted into HubSpot:
    
    -   If a HubSpot contact with the same email exists → **updated**
        
    -   If no match → **created new**
        
6.  Each exported lead is stamped with its HubSpot contact ID in RentBamboo for future bi-directional sync
    

* * *

## **Disconnecting HubSpot**

To disconnect cleanly:

1.  Go to **Settings** → **HubSpot**
    
2.  Click **Disconnect**
    
3.  RentBamboo:
    
    -   Revokes the OAuth refresh token in HubSpot
        
    -   Deletes all webhook subscriptions from HubSpot (using the hapikey)
        
    -   Removes the stored OAuth tokens and webhook subscription IDs from the database
        

Now that your data is synced in, let’s train the AI:

[

AI Agent Introduction

What each AI agent does and how it operates

](https://qdvyzaudc.gleap.help/en/articles/15-ai-agent-introduction.md)
