# HubSpot integration

{% hint style="warning" %}
This feature is restricted to premium MeltingSpot plans. If you can't access it, please contact us.&#x20;
{% endhint %}

For a quick start, you can watch this video:&#x20;

{% embed url="<https://www.loom.com/share/552b1e5c8eab4a92afc687ddaaf84c26?sid=b949bd73-af5c-4efc-9fc5-d7c7db4151b7>" %}

You will find below more details:&#x20;

## Activate the integration&#x20;

To get started, you need to activate the integration from the `HubSpot` tab on the `Integrations` page in your Spot settings. To do this :&#x20;

* Click on the `Connect to HubSpot` button.&#x20;
* A window opens, allowing you to authenticate to your account and authorize integration scopes.&#x20;
* Once authentication is complete, the window closes and you're returned to the HubSpot integration page.&#x20;

The integration is now active! 🥳&#x20;

## Initialization&#x20;

When the integration is activated, MeltingSpot creates a property group in HubSpot named “MeltingSpot” if it doesn't already exist. This group contains the following properties:&#x20;

<table><thead><tr><th width="248">Property</th><th>type</th></tr></thead><tbody><tr><td>Member Id</td><td>Member's unique identifier. </td></tr><tr><td>Member status</td><td>Member status (<code>Invited</code>, <code>Accepted</code>, <code>Pending</code>, <code>Left</code>, <code>Declined</code> or <code>Deactivated</code>).</td></tr><tr><td>Member role</td><td>Member's role in MeltingSpot (<code>Admin</code> or <code>Member</code>). </td></tr><tr><td>Member custom role</td><td>Member's custom role in MeltingSpot.</td></tr><tr><td>Spot invitation date</td><td>Member invitation date. </td></tr><tr><td>Spot registration date</td><td>Member registration date. </td></tr><tr><td>Groups</td><td>Groups to which member belongs. </td></tr><tr><td>Tags</td><td>Tags associated with member. </td></tr><tr><td>Headline</td><td>Member headline.</td></tr><tr><td>Bio</td><td>Member biography.</td></tr></tbody></table>

When integration is activated, MeltingSpot checks which Spot members (regardless of their status) have a corresponding contact in HubSpot, based on their email.&#x20;

For each HubSpot contact associated with a Spot member, MeltingSpot populates its MeltingSpot group contact properties with its member information.&#x20;

## Integration parameters&#x20;

Once integration has been activated, a certain amount of data and information is sent to HubSpot:

* Modification of HubSpot property values for a given contact: for each HubSpot contact associated with a Spot member, its property values are updated if they have been modified in the Spot. (default functionality)&#x20;
* Contact creation (feature to be activated)&#x20;
* Send activities in the contact's timeline (feature to be activated):&#x20;
  * Sending activities linked to members&#x20;
  * Sending activities related to lives&#x20;
  * Sending activities related to discussions&#x20;
  * Sending activities related to collections&#x20;
  * Sending course-related activities&#x20;

<figure><img src="/files/hu21QJ2atxyLi63iVZlr" alt="Hubspot integration"><figcaption></figcaption></figure>

### Creating contacts in HubSpot&#x20;

When the MeltingSpot - HubSpot integration is active, you can activate the contact creation option in the `HubSpot` tab of the `Integrations` page in the Spot settings.&#x20;

{% hint style="info" %}
By default, this option is disabled.&#x20;
{% endhint %}

When enabled :&#x20;

* When a new member is created in the Spot (regardless of its status), MeltingSpot checks whether it has an associated contact in HubSpot (based on the corresponding e-mail address). If it doesn't, a contact is created in HubSpot.
* Once the contact has been created, its MeltingSpot group contact properties are populated with the member's information. You can disable this option at any time by clicking on the switch.&#x20;

When the option is deactivated, no more contacts are created in HubSpot by MeltingSpot.&#x20;

{% hint style="warning" %}
Please note that when you activate member creation, HubSpot contacts are not created for existing members on the Spot. If you already have members on your Spot and wish to create the corresponding HubSpot contacts, we advise you to export your audience and import it into HubSpot.&#x20;
{% endhint %}

### Sending member activities&#x20;

When the MeltingSpot - HubSpot integration is active, you can use the `HubSpot` tab on the `Integrations` page in the Spot settings to activate one of the member activities options.&#x20;

{% hint style="info" %}
By default, all categories are disabled.&#x20;
{% endhint %}

You have several member activity categories:&#x20;

* Sending member activities&#x20;
  * *Joined the Spot*: when a new member joins your Spot.&#x20;
  * *Requested to join the Spot*: when a member requests to join your Spot (in the case of a private Spot).&#x20;
  * *Left the Spot*: when a member leaves your Spot&#x20;
* Sending live activities&#x20;
  * *Registered to a live*: when a member registers for a live event&#x20;
  * *Attended a live*: when a member participates in a live event&#x20;
  * *Watched a replay*: when a member watches a replay&#x20;
* Sending discussion activity&#x20;
  * *Voted on a topic*: when a member votes on a topic&#x20;
  * *Created a topic*: when a member creates a topic&#x20;
* Sending activities related to collections&#x20;
  * *Opened a page*: when a member opens a page-type document&#x20;
  * *Opened a link*: when a member opens a link document&#x20;
* Sending course-related activities&#x20;
  * *Started a course*: when a member starts a course&#x20;
  * *Completed a course*: when a member completes a course&#x20;

When a category is activated,&#x20;

* All activities in this category will be sent to HubSpot&#x20;
* Events will appear in a contact's activity timeline.&#x20;

When a category is deactivated, all activity dispatches for that category will stop.&#x20;

## Deactivate integration&#x20;

If you wish to deactivate the integration,

* Click on `Disconnect HubSpot`.&#x20;
* A confirmation window will appear.&#x20;
* Confirm to deactivate the integration.&#x20;

If successful, the integration will be marked as inactive, and the `Connect to HubSpot` button will reappear. This will stop all integration-related actions:&#x20;

* Contact creation&#x20;
* Editing contacts&#x20;
* Sending activities.&#x20;

## Connection issues&#x20;

If a connection problem occurs (e.g., a communication failure with HubSpot), the integration will switch to `Failed` status and the integration icon will display a warning symbol. Spot admins also receive an e-mail and in-app notification.&#x20;

**Repair the Connection**&#x20;

* Go to the HubSpot integration settings and click on `Reconnect HubSpot`.&#x20;
* You will be prompted to re-authenticate to re-establish the connection.&#x20;
* If successful, the integration will return to the Active state.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.meltingspot.io/english/manage-spot/integrations/crm-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
