All help articlesIntegrations

HubSpot

Each call can update the caller's HubSpot contact, lead or deal and log the call on it — reviewed first or written automatically.

HubSpot is connected once for the whole workspace, by an admin, from Integrations → HubSpot. Once it is connected:

  • after each call, a HubSpot update card finds the caller in HubSpot and their open lead or deal, fills in the fields you chose from what was said, and logs the call on them as a Call activity;
  • during a call, the desktop app shows the caller's HubSpot contact, company and open deals.

Setting up HubSpot

The setup takes an admin through five steps:

  1. Connect your HubSpot account. Sign in to HubSpot as a Super Admin, or as a user with Marketplace access, and approve the install. The step also shows whether ActiveLens can use Leads — see Leads below.
  2. Match your team to HubSpot owners. Members are matched to HubSpot users by email; choose one by hand where the emails differ. A call is logged as the HubSpot user its call taker is matched to, so match everyone who takes calls.
  3. Your first setup. Choose what a call updates — the caller's contact, a lead or a deal — name it, and pick the records it covers. More setups, and the fields a call fills in, are on the settings page.
  4. How HubSpot is updated. Review first or Automatic — see below.
  5. Ready. Check what calls will update and press Finish. The HubSpot page then shows the full settings.

Skip all keeps every setting as it is and goes straight to the settings page. Run setup again on the HubSpot page takes you back through the steps later.

After a call

By default, every phone call of 30 seconds or more gets a HubSpot update card among the call's actions, from the moment HubSpot is connected. It works in steps:

  1. Find the record — the caller's contact, found by their phone number first, then by a number said on the call, then by their name or business; for a meeting, by the invite's emails. Then their open lead or deal that the call is about, in one of your setups. When several contacts share the number, the card asks who called, by default. When the caller isn't in HubSpot yet, the card offers a new contact; when they have no open lead or deal, a new lead — when a setup allows one — or the contact alone.
  2. New contact or New lead — only when one is being created: its name, phone, email and owner, filled in from the call.
  3. The fields — one step per group of fields the setup fills, with values from what was said. Each field shows where its value came from.
  4. Summary — the notes for the Call activity, written from the call, with a call outcome the AI suggests. You can change both.

The card says why it picked its record and how sure it is. To pick another one, choose from the caller's open leads and deals, or press Search HubSpot and search by a name, a phone number, an email, or a lead's or deal's name. Leads and deals show only when one of your setups covers them.

Do It Now writes everything to HubSpot at once: the fields, any new contact or lead, the stage the setup moves the record to, and the Call activity on the contact, their company and the lead or deal, with an Open in ActiveLens link back to the call. A meeting is logged as a Meeting activity — or, when HubSpot already has a meeting with that contact starting within 15 minutes of it, the notes are added to that meeting instead. The transcript and the recording stay in ActiveLens.

Review first or Automatic

The first section of the HubSpot page, How HubSpot is updated, decides what happens next:

  • Review first (the default) — the card waits on the board until someone checks it and presses Do It Now. Nothing reaches HubSpot before that.
  • Automatic — HubSpot is updated right after the call. The card then says when it ran.

In Automatic, the card waits for a person instead — it says Waiting for you and why — when:

  • the caller was found only by their name;
  • the AI isn't sure enough which record the call is about (Write only when the AI is Very sure or Fairly sure), or several setups could take the call and none is where new leads start;
  • a new contact would have no number or email, or a new lead no name;
  • there are no notes to write, or HubSpot refuses a value.

Two more are switches, both on by default:

  • A new contact or lead would be created — a person decides whether to add one.
  • A required field is empty — the call didn't say what a required field needs.

With Tell the person who took the call on, they get an email saying what was written to HubSpot, or why the card waits.

Sample calls, private calls and calls in Trash never get a card after the call. You can add HubSpot update yourself from + on any call.

Undo

After a write, the card shows what changed, with links into HubSpot. Field changes can be undone from the card for 10 minutes; a field someone changed in HubSpot since is left as it is. The Call activity stays in HubSpot, and a new contact or lead has no undo — change it in HubSpot.

Nothing ActiveLens does later changes what was written. A new summary, making the call private, moving it to Trash or deleting it leave HubSpot as it is.

Setups

A setup says what a call updates. There are three kinds:

  • The caller's contact — its fields, and the Call activity on it.
  • A lead — the caller's open lead, or a new one with its contact when they have none. It needs Leads.
  • A deal — the caller's open deal. With none, the call goes on the contact.

A setup's kind is chosen when it is added; for another kind, add another setup. A new workspace starts with one contact setup and can have up to 10. In each setup:

  • Setup name — what the card calls it, for example Intake.
  • Lead types it covers and Pipelines it covers — the caller's open leads or deals the setup looks at. None picked: every type and pipeline.
  • Teams — only calls taken by people in these teams use this setup.
  • When the caller's … is found… — titled for the setup's kind, for example When the caller's open lead is found…: the fields to update on the record and its contact, and the stage the record gets once the call is written to it — or Leave the stage as it is.
  • When the caller has no open lead… (lead setups) — Let people start a new lead here, with the pipeline, stage and lead type it starts in. With Start new leads in this setup on, a call that matches no setup is offered a new lead here; people can still pick another setup.
  • The Call activity — written from the call's summary, or with one of your shared summary templates.

To choose the fields, tick them in the list — switch between the record's fields and the contact's, or search. Group them into steps: each step is a page of the card, up to 8, and Add step starts another. For each field, pick how it is filled:

  • AI — the AI fills it from the call, with an optional rule and a value to use if the call doesn't say;
  • Fixed — the same value every time;
  • Call's date — the day of the call, for a date field;
  • Person — left empty for the person to fill in on the card.

Then choose whether the field is used for existing records, new ones or both, and whether it must have a value. Fields a call can't fill — the ones HubSpot fills in by itself, and kinds of field a call can't set — are shown greyed, with the reason.

A new contact or lead is owned by the HubSpot owner of the person who took the call — or, when they aren't matched, of whoever connected HubSpot — unless the setup fills its Owner field. The card shows the owner on its New contact or New lead step, where it can be changed.

Leads

Lead setups need HubSpot's Leads permission. HubSpot shows that permission locked until a super admin allows it for the ActiveLens app. Once they have, press Reconnect HubSpot on the HubSpot page and approve Leads. Leads also need a HubSpot plan that includes them.

Without Leads, contact and deal setups still work. A lead setup's cards wait for a person, even in Automatic, and can't write a lead until Leads is allowed — only the contact.

The other settings

  • When it runs — phone calls only, or calls and meetings; the shortest call that counts; and whether a card is added after every call or only from + on the board. A live preview shows which sample calls would get a card. Which teams use each setup is set on the setup.
  • Finding the caller — when several people share one number, Ask who called, or take the Most recent contact (Automatic always takes the most recent). Same lead or deal when the AI is sets how sure the AI must be which open lead or deal the call is about; below that, the card lists them for the person to pick.

Changes collect in a bar at the bottom of the page; Save applies them all, and Discard puts them back.

Caller lookup

After a call, ActiveLens looks the caller up in HubSpot by their number, or by a meeting attendee's email. What it finds shows on the left of the call page, with a link to open it, and it looks again each time that panel opens, so you see the record as it is now. The desktop app shows the same thing during a call. Nothing is written to HubSpot.

It is on by default. To stop it, turn off Caller lookup on Integrations → HubSpot.

Ask Anything

Switch on Answer from HubSpot records to let Ask Anything answer from your HubSpot contacts, leads and deals, alongside calls and the knowledge base. Choose how many records of each kind to keep, how far back, which kinds — Contacts, Leads and Deals — whether an answer may read a record's notes and calls, how often to look for changes, and who can ask. ActiveLens keeps each record's details and a two-sentence summary, never its notes, emails or phone numbers; the record itself stays in HubSpot and is read when an answer needs it, through the connected account, so Ask Anything finds what that account sees. Leads are used only while HubSpot allows Leads (see Leads above). Pick HubSpot under Search in to ask about your HubSpot records only.

Turning it off, or Delete scanned data, deletes everything that was kept.

Your own calls

Each member can turn on Don't add HubSpot cards for my calls on the HubSpot page: their calls get no card after the call, and they can still add one from + on the board. Members see only this switch and which HubSpot user they are matched to.

Disconnect HubSpot

Disconnect on the HubSpot page uninstalls ActiveLens from your HubSpot account — HubSpot emails its admins that the app was removed. It also removes the HubSpot settings on this page, what Ask Anything kept, the owners chosen by hand and everyone's Don't add HubSpot cards for my calls switch, so connecting again starts the setup anew. Calls stay in ActiveLens, and your HubSpot contacts, companies, leads and deals are not changed.

Troubleshooting

  • A call got no HubSpot card — it was shorter than the shortest call, a meeting while only phone calls are on, a sample, private or trashed call, or the call taker turned their cards off; no setup serves the call taker's team; cards are only added from +; or your plan doesn't include AI action execution — see Plans and billing. Otherwise, add one from + on the call.
  • "Waiting for you" on an automatic card — read why on the card, fix it and press Do It Now.
  • "HubSpot refused" a field — change the value, then press Do It Now again.
  • A lead setup says "Needs Leads" — see Leads above.
  • "HubSpot needs to be reconnected" — HubSpot no longer accepts the workspace's access, often because the app was uninstalled there. Press Reconnect HubSpot.
  • The call taker isn't the activity's owner — they aren't matched to a HubSpot user, so a Call activity names them instead, and a new meeting is owned by whoever connected HubSpot. When nobody can own a new meeting, the card asks you to match the call taker first. An admin matches them under HubSpot owners.