# HubSpot

## Setup and Authentication

#### Step 1: Go to workspace settings

1. From workspace settings, go to Apps and integrations
2. On the HubSpot card, select Configure

**Note**: You must be a HubSpot admin to connect this integration

#### Step 2: Authenticate HubSpot

1. Under configuration, select Authenticate, choose the correct HubSpot account, and authorize CustomerIQ to access the required objects

#### Step 3: Configure properties

Now that you're connected, scroll down through the HubSpot configuration page to the Property Configuration tab.

For each object (Contacts, Accounts, Deals), select the properties you'd like CustomerIQ to update from logged conversations such as emails, virtual meetings, calls, or voice notes.

By selecting a property, CustomerIQ will listen for possible property values within each conversation.

When you're done selecting properties, click "Save Properties"

{% hint style="info" %}
**Property Descriptions**: CustomerIQ's AI uses your CRM property descriptions as instructions for how to complete each property. Make sure that descriptions are clear, concise, and provide context where necessary. For example, if you're asking CustomerIQ to capture a dropdown value that uses language specific to your business, like pricing plans, make sure you provide the necessary context for the AI to make the best choice.
{% endhint %}

## What to expect

### Conversations

#### When a voice note is created in CustomerIQ

* We will summarize the note and add as a note in HubSpot on the contact record
* We will search existing contact records by email in order to prevent duplicates
* Any relevant contact, account, and deal properties will be updated

#### When a meeting is created in CustomerIQ

* We will summarize the conversation and add as an internal note on the meeting activity
* We will search existing contact records by email in order to prevent duplicates
* If there is no existing meeting activity, we will create one
* Any relevant contact, account, and deal properties will be updated


---

# 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.getcustomeriq.com/data-guides/crm-and-ams-integration/hubspot.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.