The Hubspot CRM Connector app for Freshchat or Customer Service Suite enables seamless access to your CRM data within Freshchat and allows efficient synchronization between the two platforms. 

This integration is powered by the Hubspot connector app, which links contacts and accounts between Freshchat and Hubspot and provides you the flexibility to choose the direction of synchronization.

Note: The term Freshchat used in this article also applies to the Customer Service Suite product.


Ensure that you have admin permissions in Freshchat.

This article includes:
  1. Install the app
  2. Configure data sync
  3. Manage your account 
  4. Pricing

Install the app

  1. Log in to your account, go to Admin Settings > Marketplace and Integrations > Marketplace Apps.
  2. Search for the Hubspot Connector App.
  3. Click Install and connect your account.
  4. Enter the following details:
    • Freshchat domain (
    • Freshchat API key
      To find your Freshchat API Key, go to Admin Settings > Marketplace and Integrations > API settings.
      Complete the Captcha verification to view the key.
    • CRM domain
    • CRM API Key
  5. Select the agents who will have access to the Hubspot configuration.
  6. Click Install to complete the setup.
  7. Once the installation is complete, you can view the app icon on the left navigation pane. If you have more than one installed app in your account, the apps will be grouped. 

Configure data sync

To synchronize data between the Freshchat and the Hubspot CRM Connector app: 

  1. On your Freshchat account, click on the Hubspot Connector icon (full-page app) from the left navigation pane.
  2. Go to the Data sync tab and click Configure
  3. Click Connect and sign in to your Hubspot account.
  4. Select the Hubspot account to sync.
  5. Grant the app permission to access your Hubspot account.
  6. Once your Hubspot account is connected, click Proceed.
  7. Choose the direction of data flow based on your requirements:
    • Hubspot to Freshchat: One-way data flow from Hubspot to Freshchat
    • Freshchat to Hubspot: One-way data flow from Freshchat to Hubspot

      Note: The two-way data flow between Freshchat and Hubspot systems is currently unavailable.
  8. Once you choose the direction, relevant recipes will appear. You can currently sync Contact and Account information between Hubspot and Freshchat.
  9. Choose the fields you want to sync.
  10. Once the configuration is complete, click Test recipe to verify if the data is flowing.
  11. If the data flows without issues, enable the recipe's toggle to start.

Manage your account 

The Data Sync tab includes the following sections:

Analytics: This section displays the number of successful and failed jobs and the tasks consumed.

Account: You can modify the configured Hubspot account or authenticate with another user’s credentials.


The Connector app is a paid add-on priced at $80 per 5000 tasks and aligns with your billing cycle. For example, for a monthly billing cycle, tasks expire monthly or annually for an annual plan. 

To purchase the add-on:

  1. On your Freshchat account, go to Admin Settings > Account and Billing > Plans and Billing > Manage plan.
  2. Select the number of Connector App Task Packs you wish to purchase.
    Please note that you can purchase the add-on only when you have an active subscription with Freshchat.

How are tasks calculated?

Every action block in the recipe constitutes a task. The following table shows the task consumption based on the entity and direction of sync:

Sync DirectionEntity Number of Tasks

Hubspot to Freshchat

Create Contact [No Account]

New/Updated Contact [Contact with Account mapped]3

New/Updated Company

Freshchat to Hubspot

New/Updated Contact [No Company]

New/Updated Contact [Contact with Account mapped]4

Create/Update Company