# How to Connect Your VoiceB.ai Agent with HubSpot

### Prerequisites

Before you start, make sure you have:

* An active agent configured in VoiceB.ai
* A Data Collection Schema assigned to that agent (see: Create a Data Collection Schema)
* A HubSpot account with sufficient permissions to install integrations

***

### Step 1 — Activate the HubSpot Integration

Go to the main menu and click on Integrations. You will see the integrations currently active for your organization. If HubSpot is not already listed, activate it here. Once activated, HubSpot will be available to assign to any of your agents.

<figure><img src="/files/AQGARJsbn8gslPQ9zmiL" alt=""><figcaption></figcaption></figure>

***

### Step 2 — Verify Your Data Collection Schema

Go to [Data Collection](https://docs.voiceb.ai/create-a-data-collection-schema) in the main menu and confirm that the agent you want to connect has a schema configured. The fields defined in your schema (for example: name, phone, email, address) are what will appear in the HubSpot field mapping later. If you have not created a schema yet, do that first before proceeding.

<figure><img src="/files/QfHyMqVm5JunfuhzEA8d" alt=""><figcaption></figcaption></figure>

***

### Step 3 — Connect HubSpot to Your Agent

Navigate to your agent (for example, Angela) and scroll down to the Integrations section. Click the + button and select HubSpot from the list. This option will only appear if HubSpot has been activated in Step 1.

<figure><img src="/files/nuTDxqxp2dofjvO0Oyro" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/3wkkiJalcX4EehlDg8wq" alt="" width="563"><figcaption></figcaption></figure>

You will be redirected to a HubSpot login screen. Sign in with your HubSpot credentials and accept the permissions to allow VoiceB.ai to push data to your CRM. Once authorized, you will be returned to the agent configuration screen.

<figure><img src="/files/vvIMbLv8fwoFZBsnGU8d" alt=""><figcaption></figcaption></figure>

***

### Step 4 — Map Your Fields

After connecting, the HubSpot configuration panel will open automatically. This is where you tell VoiceB.ai which field in HubSpot should receive each piece of data from the call.

The top section shows the default VoiceB.ai call fields:

* Id — the unique call identifier
* Start / End — call start and end timestamps
* From / To — caller and destination numbers
* Agent — the VoiceB agent that handled the call
* Type — call type
* Status — call status
* Transcript — full call transcript (map this or set to Ignore)
* Summary — AI-generated summary (map this to Message or Ignore)
* [Tags](https://docs.voiceb.ai/tags-custom-ai-classification-for-calls-and-leads) — VoiceB classification tags (map or Ignore)

Below these default fields, you will see all the fields from your Data Collection Schema — for example Name, Phone, Email, Address. Map each one to the corresponding HubSpot contact property. For example, map VoiceB's email field to HubSpot's Email property.

<figure><img src="/files/avFcDws5P3HD5ktXx2CK" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Any field left unmapped will be ignored and will not be written to HubSpot.
{% endhint %}

***

### Step 5 — Configure Constants (Optional)

Below the field mapping, you will find the Constants section. Constants let you inject a fixed value into a HubSpot field on every call, regardless of what the agent collected. This is useful for tagging records with a source, a pipeline name, or an owner that should always be the same.

To add a constant, click Add Constant, select the HubSpot field from the dropdown, and enter the fixed value you want to inject. You can add as many constants as needed.

<figure><img src="/files/9Hl0DBkz4ONVHgXwu2hR" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Example: set HubSpot field "Lead Source" to constant value "VoiceB" so every contact created by the agent is tagged correctly in your CRM.
{% endhint %}

***

### Step 6 — Set Trigger Conditions

The Trigger Conditions section controls which call outcomes cause a record to be pushed to HubSpot. This is one of the most important settings for keeping your CRM clean.

You have two quick options at the top:

* All [outcomes](https://docs.voiceb.ai/understanding-status-and-outcomes-in-voiceb) — every call, regardless of result, pushes a record to HubSpot
* Valid only — only calls with a sales-relevant outcome push a record

Below that, you can select individual outcomes manually. The available outcomes are: Sold, Reschedule, Talk to Agent, Pending, Customer Care, Not Interested, No Answered, Busy, Voicemail, Dropped, Failed, Unreachable, Not Found.

<figure><img src="/files/wDbnJu7laVDx0Wxofijw" alt=""><figcaption></figcaption></figure>

For most sales use cases, we recommend selecting Valid only, which covers Sold, Reschedule, Talk to Agent, and Pending. This prevents invalid calls, voicemails, and no-answers from polluting your CRM pipeline.

<figure><img src="/files/Rr8xMIOuxfOJkIvTzZei" alt=""><figcaption></figcaption></figure>

If you only want closed deals in HubSpot, select Sold only.

***

### Step 7 — Save

Click the Save button. Changes are applied immediately. From this point forward, every call that matches your trigger conditions will push data to HubSpot in real time — no delays, no manual imports.

***

### Deleting the Integration

If you need to remove the HubSpot integration from an agent, scroll to the bottom of the configuration panel and click the red Delete Integration button. This removes the connection for that agent only and does not affect other agents or your organization-level HubSpot activation.

***

### Need Help?

If you run into login issues, field mapping problems, or want to extend the integration to HubSpot workflows or deal creation, contact support via the Help Center.


---

# 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://docs.voiceb.ai/how-to-connect-your-voiceb.ai-agent-with-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.