Help Center

CRM Integration

Connect HubSpot with KaiCalls.

Send caller details and call summaries straight into your HubSpot CRM as contacts and activity notes.

Kai handing off a lead to HubSpot

OAuth approval

Authorization

Sign in to HubSpot and approve the KaiCalls app.

Contacts & Notes

Data created

Makes a contact record and adds a call note to their activity.

Auto-matching

Phone lookup

Matches repeat callers to their existing contact record.

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.
HubSpot portal showing contacts and call summaries created by KaiCalls
Contacts and call notes created directly in your HubSpot portal.

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. 1

    Open Connections in KaiCalls

  2. 2

    Click Connect HubSpot

    You will see the secure HubSpot authorization window.
  3. 3

    Choose your account

    If you have multiple portals, select the right company and click Choose Account.
  4. 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. 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. 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. 1

    Open the HubSpot card

    Go to Connections > HubSpot. Find the box called Import a HubSpot list.
  2. 2

    Pick a list

    Search by name. Then pick the list you want.
  3. 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. 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. 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.