---
title: How do I set up the HubSpot CRM integration?
description: Crystal's native HubSpot integration allows you to view Crystal's rich personality data directly in your CRM.
---

[Skip to content](https://docs.crystalknows.com/setting-up-hubspot-crm-integration#main-content)

English

Show submenu for translations

![crystal\_large](https://docs.crystalknows.com/hs-fs/hubfs/crystal_large.png?width=220&height=54&name=crystal_large.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Contact Support](https://www.crystalknows.com/contact)

[Contact Support](https://www.crystalknows.com/contact)

 Welcome! How can we help?

- There are no suggestions because the search field is empty.

1. [Help Center](https://docs.crystalknows.com/)
2. [Integrations](https://docs.crystalknows.com/integrations)
3. [HubSpot](https://docs.crystalknows.com/integrations#hubspot)

# How do I set up the HubSpot CRM integration?

## Crystal's native HubSpot integration allows you to view Crystal's rich personality data directly in your CRM.

Connect your Hubspot account and automatically enrich your contacts with Crystal’s personality data. Leverage new data fields - like DISC type, DISC Overview, behavioral traits, and more - for your Contacts.

Enabling this feature will use your organization's credits for each contact that is matched.  See configuration options below in Step 4 for options to specify which contacts are enriched.

### **Hubspot - Implementation Instructions:**

#### Step 1: Navigate to Crystal's [Integrations Page](https://www.crystalknows.com/app/team/integrations)

Click the Hamburger Menu ➞ Organization ➞ Integrations

- Click ***Add Hubspot***

![Step 1](https://docs.crystalknows.com/hs-fs/hubfs/Frame%2015912%20(2).png?width=688&height=234&name=Frame%2015912%20(2).png)

#### Step 2: Connect your CRM account

#### **Click Connect ➞ Sign in**

- **This will automatically create new fields in your CRM. You may have to adjust permissions to show the newly created fields and/or edit where they show up in your views.**

**![Step 2](https://docs.crystalknows.com/hs-fs/hubfs/image%2028%20(4).png?width=688&height=336&name=image%2028%20(4).png)**

#### Step 3: Configure your CRM

Add your API key which can be found on your Organization Settings page under the API section.

- Mapping the CRM field which contains the LinkedIn URL is helpful for match rates but not required.

#### ![Step 3](https://docs.crystalknows.com/hs-fs/hubfs/Screenshot%202023-08-08%20at%204.24.png?width=688&height=456&name=Screenshot%202023-08-08%20at%204.24.png)

#### Step 4: Select your enrichment configuration by toggling on the most appropriate options

The options below will allow you to control which contacts are enriched by Crystal.  Each enrichment will cost a credit.

See which enrichment configuration options below fits best with your processes.  
![Step 4](https://docs.crystalknows.com/hs-fs/hubfs/image%2033%20(1).png?width=688&height=381&name=image%2033%20(1).png)

- **Enrich Contact**  
  When this setting is turned on, it will  add personality data to every new contact upon creation.

- **Conditionally Enrich Contact**  
  This option allows you to enrich contacts that meet a certain field condition. This is helpful if you want to only enrich contacts that fall into a certain lifecycle or lead status.

- - i.e. *Lifestyle Stage \> Sales Qualified Lead* triggers a contact to be enriched
    - To use a **check box**, set the field to be the name of the field, and the value to be ***true*** will enrich all of your contacts that are/become Sales Qualified Leads.
- **Conditionally Enrich Checkbox**  
  This option allows users to manually click on a checkbox field in Hubspot to trigger the enrichment of a contact. LinkedIn URL is not a mandatory field but is helpful for match rate.
- **\*Push Data to Contact Record**  
  This option allows you to selectively send data from profiles created in Crystal (using the Chrome Extension or Dashboard search) back to your Hubspot account. This configuration will either match to an existing contact record, or create a new one if one does not exist.  
    - - \*This option can be selected in addition to any of the three configuration options mentioned above (Enrich Contact, Conditionally Enrichment Contact, or Conditionally Enrich Checkbox).

#### Step 5: Click the X in the top left-hand corner of the window to close out of the integration setup.

- Selections save automatically.

***NOTE**: Integrations and integrations support is only currently available for users on our Business or Enrichment plan. [Speak with our team to learn more](https://www.crystalknows.com/request-a-demo).*

- [Video Tutorial Library](https://docs.crystalknows.com/video-tutorial-library#main-content)

    - [Admin Access](https://docs.crystalknows.com/video-tutorial-library#admin-access)
    - [Crystal’s Integrations](https://docs.crystalknows.com/video-tutorial-library#crystals-integrations)
    - [Crystal for Me: Understanding Yourself](https://docs.crystalknows.com/video-tutorial-library#crystal-for-me-understanding-yourself)
    - [Crystal for Teams: Understanding Your Coworkers](https://docs.crystalknows.com/video-tutorial-library#crystal-for-teams-understanding-your-coworkers)
    - [Crystal for Hiring: Understanding Your Candidates](https://docs.crystalknows.com/video-tutorial-library#crystal-for-hiring-understanding-your-candidates)
    - [Crystal for Sales: Understanding Your Buyers and Clients](https://docs.crystalknows.com/video-tutorial-library#crystal-for-sales-understanding-your-buyers-and-clients)
    - [Crystal for Leaders: Understanding Your Style and Your Direct Reports](https://docs.crystalknows.com/video-tutorial-library#crystal-for-leaders-understanding-your-style-and-your-direct-reports)
- [What is the DiSC framework?](https://docs.crystalknows.com/what-is-the-disc-framework)
- [Creating Personality Profiles](https://docs.crystalknows.com/creating-personality-profiles)
- [How to use the Chrome Extension](https://docs.crystalknows.com/how-to-use-the-chrome-extension)
- [How to use our Playbooks](https://docs.crystalknows.com/how-to-use-our-playbooks)
- [How to use our API](https://docs.crystalknows.com/how-to-use-our-api)
- [Using Crystal for my business](https://docs.crystalknows.com/using-crystal-for-my-business#main-content)

    - [Crystal for Sales](https://docs.crystalknows.com/using-crystal-for-my-business#crystal-for-sales)
    - [Crystal for Teams](https://docs.crystalknows.com/using-crystal-for-my-business#crystal-for-teams)
    - [Crystal for Hiring](https://docs.crystalknows.com/using-crystal-for-my-business#crystal-for-hiring)
- [Account Settings & Billing](https://docs.crystalknows.com/account-settings-billing)
- [Integrations](https://docs.crystalknows.com/integrations#main-content)

    - [Salesforce](https://docs.crystalknows.com/integrations#salesforce)
    - [HubSpot](https://docs.crystalknows.com/integrations#hubspot)
- [FAQ](https://docs.crystalknows.com/faq)
- [What is Crystal Meetings App](https://docs.crystalknows.com/what-is-crystal-meetings-app)

[![Crystal](https://docs.crystalknows.com/hs-fs/hubfs/Crystal%20Logo%20(1)-5.png?width=150&height=37&name=Crystal%20Logo%20(1)-5.png "Crystal")](https://www.crystalknows.com)

Copyright © 2026, Crystal