# HubSpot

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

Source: https://app.activelens.ai/help/hubspot

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](/help/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**.

## Related

- [Connect an integration](/help/connecting-an-integration)
- [Actions on a call](/help/action-items)
- [My call did not appear](/help/call-not-showing-up)
