Connectors

/

HubSpot

/

Add a new HubSpot contact
Write

Add HubSpot contacts once, linked to the right company

For sales teams who want new people in HubSpot without the duplicate search, just by asking their AI assistant.

Try PopdockAI free
Get a live demo
Add a new HubSpot contact
Add Dana Whitfield, dana@northwindtraders.com, Head of Finance at Northwind Traders, to HubSpot.
No HubSpot contact uses that email, so this will be a new contact. - Contact: Dana Whitfield, dana@northwindtraders.com - Job title: Head of Finance - Company: Northwind Traders, matched by the northwindtraders.com domain Shall I create it?
HubSpot
Sample figures. Your results come from your own account.
hubspot-get-contacts
hubspot-get-companies
hubspot-add-company
hubspot-add-contact

On this page

The problem

The problem

The prompt

Who it's for

How it works

Tools used

Connector

HubSpot

HubSpot
Run it on your own HubSpot data.

Connect HubSpot, pick your AI tool and paste the prompt.

Try PopdockAI free

The problem

Every new HubSpot contact starts with a duplicate search

Before you add a person to HubSpot you have to search for their email, then find their company or decide whether to create it. Skip a check and you get two records for the same person, or a contact linked to no company.

Without PopdockAI

  • Search HubSpot for the email before adding anyone
  • Hunt for the company by name and guess from the domain
  • Create the company by hand when it is missing
  • Merge the duplicates that still slip through

With PopdockAI

  • The email is checked for an existing contact before anything is written
  • The company is matched by name and email domain, ignoring free mail
  • A new company is only created if you say yes
  • The saved contact is read back to show it landed and is linked

The prompt

Use this prompt

Copy it into any AI tool connected to PopdockAI. Swap the values in braces for your own.

Prompt
**Objective:** Add `{full-name}` (`{email}`), `{job-title}` at `{company-name}`, as a HubSpot contact without creating duplicates.

**Step 1: Duplicate check**

Call `hubspot-get-contacts` with `email` = `{email}`. If a contact exists, show it and stop: offer the update-contact-details prompt instead.

**Step 2: Company**

If `{company-name}` is given, call `hubspot-get-companies` with `company-name.contains`. Also try `company-domain-name` = the part of `{email}` after the @, unless it is a free mail domain (gmail.com, outlook.com, yahoo.com and the like).

* One match: use its exact company name.
* Several: list them and ask which.
* None: ask whether to create the company. Only create it on an explicit yes.

**Step 3: Confirm**

Show first name, last name (split `{full-name}` on the last space), email, job title, company, and whether a company will be created. Wait for an explicit yes.

**Step 4: Create**

* If agreed, call `hubspot-add-company` once with `name` and, for a non-free domain, `domain`.
* Call `hubspot-add-contact` once with `email`, `first-name`, `last-name`, `job-title` and `company-name`.

**Step 5: Verify**

Call `hubspot-get-contacts` with `email` = `{email}` and report the stored record, including whether `company-id` is set.

**Rules & Guidelines:**

* Only `hubspot-add-company` (when agreed) and `hubspot-add-contact` may write, each once.
* Do NOT call any other write tool: `hubspot-add-deal`, `hubspot-add-ticket`, `hubspot-update-contact`, `hubspot-update-company`, `hubspot-update-deal`, `hubspot-update-ticket`, `hubspot-add-contact-note`, `hubspot-add-company-note`, `hubspot-add-deal-note`, `hubspot-add-ticket-note`.
* Do not set `owner-id`. No tool maps a person's name to a HubSpot owner ID, so leave ownership unchanged unless the user gives you a numeric owner ID.
* Do not set lifecycle stage or lead status unless the user asks.

**Validation:**

* If `{email}` is not a valid address, stop and ask for it.

Who it's for

One answer, three teams that use it

Sales reps

Log new contacts straight from a call

Add a person you just spoke to in one message, already linked to their company, without searching HubSpot first.

Add Priya Shah, priya@contoso.com, Procurement Manager at Contoso, to HubSpot.

Business development reps

Capture event leads without duplicates

Add the people you met at an event one by one, with each email checked so nobody already in HubSpot gets a second record.

Add Tom Reyes, tom.reyes@fabrikam.com, Operations Director at Fabrikam, to HubSpot and check he is not already there.

Sales operations

Keep HubSpot contacts tied to companies

Every new contact is matched to a company by name and domain, so fewer records end up floating with no account attached.

Add lee@northwindtraders.com, Lee Wong, Buyer, to HubSpot and link him to the Northwind Traders company.

How it works

What PopdockAI does when you ask

You give the person's details in plain words and your AI assistant checks HubSpot for duplicates and the right company. Nothing is saved until you have seen the contact and said yes.

01

Ask

You give a name, email, job title and company.

Your AI tool

02

Check

It searches HubSpot for the email and matches the company by name and domain.

hubspot-get-contacts
hubspot-get-companies

03

Confirm

You see the exact contact, and any new company, and say yes.

No items found.

04

Create

It saves the contact and reads it back to show it landed and is linked.

Your AI tool

What PopdockAI provides

The tools behind the answer

Ready made tools for HubSpot and one secure connection to your AI tool. No code, no exports.

get-data

hubspot-get-contacts

Returns contact records from HubSpot CRM, with email, phone, company, lifecycle stage, lead status, owner and location from the HubSpot connector. Filter by company id, state region, contact owner, email, last name, create date, company name, record id, lifecycle stage, lead status.
get-data

hubspot-get-companies

Returns company records from HubSpot CRM, with domain, industry, lifecycle stage, owner, location and revenue from the HubSpot connector. Filter by record id, company domain name, industry, lifecycle stage, annual revenue, state region, company owner, company name, create date, country region.
run-action

hubspot-add-company

Creates a company in HubSpot and returns the new company's ID. Requires name. Optional: phone, country, state, owner id, domain, city, lifecycle stage, description.
run-action

hubspot-add-contact

Creates a contact in HubSpot and returns the new contact's ID. Requires email. Optional: phone, last name, company name, first name, lead status, lifecycle stage, owner id, job title.
Read only.Nothing in HubSpot Changes

This report is built from Get data tools only. PopdockAI applies the row, field and parameter rules your admin sets, and every query is written to the audit trail.

How Popdock AI secures your data

The outcome

One clean HubSpot record for every new contact

Try PopdockAI free
Get a live demo

Related use cases

More ways to put this data to work

All Ramp use cases

One prompt template with infinite possibilities.

‍

Your AI assistant adapts its approach, tone, and capabilities to match each unique context while you maintain a single, manageable workflow.

Join forward-thinking companies that are transforming their operations with intelligent, secure AI automation.

Try PopdockAI Free
See Documentation