> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.co-din.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to connect Crisp to Hubspot?

**This plugin is available in Crisp Unlimited. The Crisp ↔️ Hubspot plugin allows a two way contact synchronization as well as the possibility to view and create deals associated to a contact directly from Crisp. Additionally, it is possible to see which Hubspot lists a contact is part of.**

| All the new or updated contacts you have in Crisp are sent to Hubspot and all the new and updated contacts in Hubspot are automatically synced to Crisp CRM.

###### Contents
* [Connecting Hubspot to Crisp](#1-connecting-hubspot-to-crisp)
* [How does the plugin work?](#1-how-does-the-plugin-work)
* [Import my previous contacts](#1-import-my-previous-contacts)

# Connecting Hubspot to Crisp

1. Initiate the [plugin installation here](https://app.crisp.chat/initiate/plugin/c0e71a40-d51d-4f4d-a1a7-d1e8689035c0/) and select a Crisp workspace to install the Hubspot plugin on.
2. Click on **Connect to Hubspot** to be redirected to Hubspot.
3. Select which Hubspot account to connect Crisp to (If you have more than one Hubspot account).
4. Finally, click **Connect App** and you should be redirected back to Crisp.
5. (Optional) - Configure the plugin settings, to prevent whether or not Crisp operators with "Member" permissions can add/remove customers to lists, create deals and more!

The plugin is now connected and ready to use!

# How does the plugin work?

##### Contact Synchronization

All the **new contacts** that you add on Hubspot are directly added to Crisp. If you update a contact in Hubspot, it's also updated in Crisp. As the plugin is dual-sync, it works the same on Crisp's side. When a new contact is added to Crisp, it's automatically added to Hubspot. Any modification you do on Crisp is reflected on Hubspot too. It is also possible to use the plugin as a one way sync from Crisp to Hubspot or visa-versa, all you need to do is disable the contact sync in the plugin settings.

|| Note that the plugin does not create leads but **contacts**.

Create a new contact in Hubspot and the contact will instantly be added to Crisp's CRM:

![](https://storage.crisp.chat/users/helpdesk/website/a4823be626ad8800/husbpot_qlfpbz.png)

| All new Hubspot's contacts will have the segment `hubspot` so you'll know where the contact comes from.

###### What contact data is synced? 

**From ${color}[#0092ee](Crisp) to ${color}[#fe7a58](Hubspot): **
* **Email** - The email of the Crisp contact is synced to an existing Hubspot contact. If there is no Hubspot contact, a new one is created.
* **Name** - The name will be split into a first and last name in Hubspot. If the Crisp has more than 3 name **(eg. John Patrick Doe)** it will all secondary names will be saved as the last name. **(eg.  First name: John, Last name: Patrick Doe)**
* **Website: ** - The contacts website.
* **Phone** - The contact phone number.
* **Address** - The contacts address.
* **Gender** - The contacts gender.
* **Job title** - The contacts job title.
* **Company** - The company the contact is part of.

**From ${color}[#fe7a58](Hubspot) to ${color}[#0092ee](Crisp): **
* **Email** - The email of the Crisp contact is synced to an existing Crisp contact. If there is no Crisp contact, a new one is created.
* **First name** - The first name of the contact is saved as the Crisp name.
* **Last name** - If the contact has a last name, it is appended to the Name on Crisp.
* **Hubspot Segment** - A `hubspot` segment is added to the contact only when a new contact is added from Hubspot to Crisp.
* **Website: ** - The contacts website.
* **Phone** - The contact phone number.
* **Address** - The contacts address.
* **City: ** - The city is appended to the contacts address on Crisp.
* **Zip code** - The zip code is appended to the contacts address on Crisp.
* **State** - The state is appended to the contacts address on Crisp.
* ** Custom fields ** - Custom fields configured from the plugin settings in Crisp are all saved as custom data on the Crisp contact.

| Enable which custom contact properties from Hubspot you would like to synchronize to Crisp from the Hubspot plugin settings.

###### Hubspot Widget

The Hubspot widget allows your Crisp operators to view all **Deals** and **List Memberships** of a contact with direct links to the contacts Hubspot profile, a specific deal or even a list. A deals priority or stage can be quickly updated and a contact can also be easily removed from a Hubspot list:

![View contact deals and list memberships](https://storage.crisp.chat/users/helpdesk/website/a4823be626ad8800/slice-copy_1raz7oc.png)

The integration also allows you to create a deal, or add a contact to a static list too:

![Create Hubspot deal](https://storage.crisp.chat/users/helpdesk/website/a4823be626ad8800/create-deal_1x0skjo.png)
![Add contact to list](https://storage.crisp.chat/users/helpdesk/website/a4823be626ad8800/add-list_lsikmd.png)

| It is also possible to view custom deal fields in the widget but enabling the deal properties from the Hubspot plugin settings. All additional fields will be shown in the **Additional information** section of a deal.

# Import my previous contacts

You may want to add your previous contacts in Crisp. In order to do that, you have to download your contact list in Hubspot as a CSV. 

* Click **Table Actions** then **Export View** 

![Export Hubspot's contacts](https://storage.crisp.chat/users/helpdesk/website/a4823be626ad8800/export_1no5mi1.png)

* Then navigate to **Crisp > Contacts > Import the CSV** to Crisp:

![Import contacts in Crisp](https://storage.crisp.chat/users/helpdesk/website/a4823be626ad8800/import_ur2wg.png)

| You can learn more about CSV import in Crisp in this [article](https://help.crisp.chat/en/article/how-to-import-my-user-data-dcukz8/)

# Troubleshooting

In that case, just contact our team, we'll be happy to solve your issue.
