Overview
What the HubSpot connection does.
Kai captures caller info and logs notes directly into your portal.
Creates new contacts
When someone calls your number, Kai gets their name, phone number, and address. If they are new, he creates a contact record in HubSpot.
Writes call notes
Kai summarizes the call. He saves the summary and transcript link to the contact activity feed.
Updates existing leads
If a customer calls again, Kai finds their phone number in HubSpot and adds a new note to their history without making a duplicate.
Assigns lead source
Kai tags new contacts with the lead source so your marketing reports stay clean.

Prerequisites
Before you connect.
1. HubSpot portal access
You must have super admin or app marketplace permissions in your HubSpot portal.
2. Free or paid plans
KaiCalls works with all HubSpot tiers, including free CRM, Starter, and Professional.
Setup
How to connect your HubSpot portal.
Authorize the correct portal, choose your sync rule, then verify a destination record.
- 1
Open Connections in KaiCalls
Go to Connections > HubSpot. - 2
Click Connect HubSpot
You will see the secure HubSpot authorization window. - 3
Choose your account
If you have multiple portals, select the right company and click Choose Account. - 4
Approve access and return to KaiCalls
Review the requested permissions and approve access. Return to KaiCalls and confirm the connected Hub ID. Authorization alone does not prove a contact was delivered. - 5
Choose when calls should sync
In the HubSpot connection, Send calls automatically starts on Every caller for a new connection. Choose Qualified callers only, or Off — push leads by hand, if you want less. These settings save in the dashboard; there is no custom field mapper on this card. - 6
Verify a destination record
Use the verification checklist below. A controlled call or manual push can create real HubSpot records and trigger your CRM automations.
Import
Import a HubSpot list as leads.
Bring the people on one HubSpot list into KaiCalls, so you can text them.
- 1
Open the HubSpot card
Go to Connections > HubSpot. Find the box called Import a HubSpot list. - 2
Pick a list
Search by name. Then pick the list you want. - 3
Pick your text opt-in field
Choose the HubSpot field that says a person agreed to get texts, like a checkbox on your form. Then pick the answer that means yes. If you do not have one, leave it blank. - 4
Click Import list
You will see how many leads are new, how many were updated, and how many can get texts. Big lists come in parts. Click Import the next part to keep going. - 5
Text them
Start a text campaign. Pick the source shown after the import, like hubspot_spring_open_house.
We only text people your HubSpot field says agreed to texts. A phone number alone is not a yes. Everyone else is saved as a lead, but a text campaign skips them. HubSpot does not share its own text sign-up list with apps, so you must pick a field. If you connected HubSpot before this, click Reconnect HubSpot once so we can read your lists.
Verification
How to prove it worked.
Check an actual contact after an authorized manual push or ordinary controlled call.
- With Off selected, manually push a lead from KaiCalls. To check automatic delivery, save the intended rule and use an ordinary controlled call with recognizable details.
- Built-in test-mode, demo, and sample calls are excluded from automatic call syncing. Qualified callers only also needs a qualified caller.
- Give a test name like "Peter Parker" and say you need an estimate.
- Wait for call processing or the manual push result. Check any delivery error instead of assuming a fixed wait means success.
- Open your HubSpot portal and click CRM > Contacts.
- Confirm "Peter Parker" appears with the correct mobile number.
- Open the contact record: Confirm the note shows the call summary and recap.
Troubleshooting
Fix common HubSpot issues.
Contacts not appearing
Confirm you connected the right HubSpot portal ID. If you manage multiple portals, check your portal selector.
Notes missing from timeline
In HubSpot, click Filter activity on the contact timeline. Ensure Notes and Call activities are checked.
Permission error during connect
You must have App Marketplace permissions in HubSpot to install third-party apps. Ask your account admin to connect it.
Session expired
Click Reconnect on the HubSpot card in KaiCalls to refresh your login token.
Leaving
How to disconnect HubSpot.
Click Disconnect on the HubSpot card in KaiCalls anytime. Kai will stop sending contacts and notes. Contacts and call history already in your HubSpot portal stay there.
