HubSpot CRM Integration

The HubSpot CRM integration lets your AI sales assistant create and manage leads, deals, and contacts directly in your HubSpot account. Your AI assistant handles CRM work during the conversation — no manual data entry — so sales and customer records stay up to date automatically.

At a glance

You need	Where	Result
Admin access to HubSpot	Settings > Integrations > Private Apps	Create a private app
A private app API key (all scopes)	HubSpot private app	Token to authenticate MyChatBot
The assistant connected	MyChatBot Integrations tab	Paste the key into Access Token, click Submit
Entities & fields enabled	Entities & Data Fields Configuration	Leads / Deals available to the assistant

Connect in 3 steps:

1. Create a HubSpot private app and copy its API key.
2. In MyChatBot, select your assistant, connect HubSpot under CRM Systems, and paste the key.
3. Enable entities (Use Leads / Use Deals), select the fields the assistant may fill, then click Apply fields.

Once connected, your assistant can

• Create a lead when a customer shows interest.
• Update a lead (change its status/stage, edit details) as the conversation progresses.
• Create a deal, optionally with product line items.
• Create or update a contact.

Each of these maps to an entity you enable in the field configuration — you don't call anything by hand, the assistant decides when to act based on its instructions.

Create an API key in HubSpot

1. Log in to your HubSpot account as an administrator.
2. Navigate to Settings > Integrations > Private Apps.
3. Click Create a private app.
4. Provide a name for your app (e.g. "MyChatBot Integration").
5. Select all scopes to allow the necessary access, including:
   • CRM
   • CMS
   • Communication preference
   • Marketing
   • Settings
   • Other
6. Click Create App to generate your API key.
7. Copy your API key — you'll need it to set up the integration in MyChatBot.

Connect the integration in MyChatBot

In the app

Open Integrations, pick your assistant, find HubSpot under CRM Systems, and click Connect → app.mychatbot.app/integration?integration=Hubspot

1. Open the Integrations tab in your MyChatBot dashboard.
2. Select the assistant you want to connect to HubSpot.
3. Scroll to CRM Systems and find HubSpot in the list.
4. Click Connect.
5. Paste your HubSpot API key (the key you created above) into the Access Token field.
6. Click Submit to save the integration.

Entities & data fields configuration

After connecting your HubSpot account, choose which entities and fields your assistant can access. This section is titled Entities & Data Fields Configuration — "Select the entities and their fields you want the assistant to fill."

1. Toggle Use Leads to let the assistant manage leads, and Use Deals to let it manage deals.
2. For each enabled entity, pick the fields the assistant may write. HubSpot lists all of the entity's properties, plus a Status field, under Most used custom fields and Other custom fields; there is no separate standard-fields section.
3. Click Apply fields to save your selection.

There is no pipeline picker and no Sync statuses button for HubSpot. Leads are placed in your HubSpot pipeline named Lead pipeline, and deal stages are looked up in the pipeline named Sales Pipeline. Stage names are read from HubSpot each time the assistant sets a status.

Entity types

The HubSpot integration works with two entity types you can switch on:

• Leads — potential sales opportunities.
• Deals — sales transactions in progress.

Contacts are not a separate entity in the configuration: the assistant finds or creates the contact as part of its lead and deal actions.

Field types

Each entity lists its HubSpot properties, both built-in and the ones you've defined, split into Most used custom fields and Other custom fields.

Only the fields you tick (and click Apply fields on) are ones the assistant is allowed to fill.

Fields that behave specially

A few fields deserve extra attention:

Field / concept	What to know
Status (lead stage)	The current stage in the lead pipeline (e.g. "New", "In Progress", "Qualified", "Disqualified"). It must match the name of a stage in your HubSpot Lead pipeline exactly.
Source	Auto-filled by MyChatBot to mark records that came from the AI. Leads are tagged with "AI-" plus your assistant's name; deals are tagged with the communication channel or "AI". Great for reporting on AI-sourced pipeline.
Chat link	Auto-added to every lead and deal. It links the CRM record back to the exact conversation that generated it, so your team can read the full context in one click.

HubSpot statuses must match exactly

Status values must match the stage names in your HubSpot account exactly. A mismatched status string won't map to a pipeline stage, and the record can land in the wrong place. After you rename stages in HubSpot, update the names in your assistant's instructions too.

Working with products

Deals can include products as line items. When the assistant creates a deal, it can attach one or more products, each with:

• name — product name.
• sku — product SKU (needed if a new product must be created).
• price — product price.
• quantity — number of units.

The assistant matches an existing HubSpot product when it can (by product or line-item reference, or by name/SKU) and creates a new product only when no match exists. MyChatBot keeps the deal linked to the originating conversation so the order context is never lost.

What your assistant can do in HubSpot

Once connected, the enabled entities give your assistant these capabilities. You don't trigger them manually — the assistant acts based on its instructions and the conversation.

Capability	What the assistant does	Enable via
Create a lead	Adds a new lead, finds-or-creates a matching contact by phone, links them, sets the status, tags the source as AI, and adds the chat link.	Use Leads
Update a lead	Edits an existing lead — name, phone, status/stage, or any configured field.	Use Leads
Create a deal	Adds a new deal, attaches product line items, finds-or-creates the contact, sets the deal stage, and adds the chat link.	Use Deals
Create / update a contact	Creates a contact (name and phone required) or updates an existing one; if a matching lead exists it's updated too, and the client's record in MyChatBot stays in sync.	Contacts (auto with Leads/Deals)

Every field you tick in Entities & Data Fields Configuration becomes something the assistant is allowed to fill for these actions — so the fields you enable directly control how much detail lands in HubSpot.

Require a phone number

Under the field configuration you can toggle Lead Phone Required / Deal Phone Required so the assistant must capture a phone number before creating a record. Since contacts are matched by phone, this keeps duplicates down.

Guiding the assistant from its instructions

The assistant creates and updates CRM records based on your assistant instructions — write these in plain language. You don't reference any function names; just describe when and with what the assistant should act.

In the app

Edit these in your assistant's Instructions — app.mychatbot.app.

Creating leads:

When a customer expresses interest in our services, create a lead in HubSpot:
- Use their name as the full name
- Include their phone number
- Set the status to "New"
- Fill in any other relevant fields

Creating deals:

When a customer confirms they want to buy, create a deal in HubSpot:
- Use their full name and phone number
- Add the products they're interested in (name, SKU, price, quantity)
- Set the deal stage to "Appointment Scheduled"

Updating lead status:

When a customer asks for a call back:
- Update the lead status to "In Progress"
- Note the preferred callback time

When a customer confirms interest:
- Update the lead status to "Qualified"
- Add any extra details

Adding contacts:

When talking with a new customer:
- Create a contact with their full name and phone number
- Let them know their details have been saved
- Continue the conversation

Remember: status names in your instructions must match your HubSpot pipeline stages exactly, and only fields you enabled in the configuration will be written.

See also

• Integrations overview