Connectors

/

HubSpot

/

Update HubSpot contact details
Write

Update HubSpot contacts with the old values kept

For sales teams who want contact edits made safely, without email clashes or lost history, by asking their AI assistant.

Try PopdockAI free
Get a live demo
Update HubSpot contact details
Update jordan@fabrikam.com in HubSpot: new job title Finance Director and phone 555 0142.
Here are the changes for Jordan Lee at Fabrikam. - Job title: Controller to Finance Director - Phone: 555 0100 to 555 0142 Shall I save these? The old values will be kept in a note.
HubSpot
Sample figures. Your results come from your own account.
hubspot-get-contacts
hubspot-update-contact
hubspot-get-companies
hubspot-add-contact-note

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

Contact edits can clear fields and lose old values

Editing a HubSpot contact by hand risks clearing fields by accident, giving them an email that belongs to someone else, or changing values with no record of what they were before.

Without PopdockAI

  • Open the contact and edit fields by hand
  • Hope the new email is not someone else's
  • Check the new company exists
  • Lose the old values with no record

With PopdockAI

  • Each change is mapped to a field, and ones it cannot change are named
  • A new email is checked against other contacts and a new company must exist
  • You see current and new values before saving
  • Only changed fields are sent, old values are noted and read back

The prompt

Use this prompt

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

Prompt
**Objective:** Apply `{changes}` to the HubSpot contact `{contact-email}`, changing nothing else.

**Step 1: Find the contact**

Call `hubspot-get-contacts` with `email` = `{contact-email}`. If none or several match, stop and say so.

**Step 2: Map the changes**

Map each requested change to a `hubspot-update-contact` parameter: `first-name`, `last-name`, `email`, `phone`, `job-title`, `company-name`, `lifecycle-stage`, `lead-status`, `owner-id`. If a change maps to none of these, say it cannot be made with this tool and leave it out.

**Step 3: Check**

* If the new `email` already belongs to another contact (`hubspot-get-contacts` with `email`), stop.
* If `lifecycle-stage` would move backwards, warn: HubSpot may refuse it.
* If `company-name` changes, check the company exists with `hubspot-get-companies` and say the company association is not changed by this tool.

**Step 4: Confirm**

Show a table: field, current value, new value. Wait for an explicit yes.

**Step 5: Update and log**

Call `hubspot-update-contact` once with `id` = the record-id and only the changed fields. Then call `hubspot-add-contact-note` once listing the changes ("Updated: job title CFO (was Finance Director)").

**Step 6: Verify**

Re-read the contact with `hubspot-get-contacts` by `record-id` and report each field's stored value.

**Rules & Guidelines:**

* Only `hubspot-update-contact` and `hubspot-add-contact-note` may write, each once, after confirmation.
* Do NOT call any other write tool: `hubspot-add-contact`, `hubspot-add-company`, `hubspot-add-deal`, `hubspot-add-ticket`, `hubspot-update-company`, `hubspot-update-deal`, `hubspot-update-ticket`, `hubspot-add-company-note`, `hubspot-add-deal-note`, `hubspot-add-ticket-note`.
* Never send a field you are not changing; an empty value clears it.
* 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.

**Validation:**

* If `{changes}` is ambiguous, ask before mapping it.

Who it's for

One answer, three teams that use it

Sales reps

Update a contact after a conversation

Record a new title or phone number in one message, with the old values kept on record.

Update priya@contoso.com in HubSpot: job title VP Procurement, phone 555 0199.

Customer support agents

Fix contact details on request

Change a customer's email safely, with a check that it does not belong to someone else.

Change tom.reyes@fabrikam.com's email in HubSpot to t.reyes@fabrikam.com.

CRM administrators

Keep a trail of contact changes

Every update adds a note with the previous values, and backward stage changes get a warning.

Move dana@northwindtraders.com to the company Northwind Traders and set her lifecycle stage to customer.

How it works

What PopdockAI does when you ask

You give the contact's email and describe the changes, and your AI assistant checks them before anything is saved. You see current and new values and confirm first.

01

Ask

You give the contact's email and describe the changes.

Your AI tool

02

Check

It maps each change to a field, checks a new email and company, and warns on backwards stages.

hubspot-get-contacts
hubspot-get-companies

03

Confirm

You see current and new values side by side and say yes.

No items found.

04

Update

It sends only the changed fields, notes the old values and reads it back.

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.
run-action

hubspot-update-contact

Changes an existing HubSpot contact. Only the fields you pass are changed; pass an empty value to clear a field. Requires id. Optional: last name, lead status, owner id, company name, email, job title, first name, lifecycle stage, phone.
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-contact-note

Adds a note to a HubSpot contact's timeline. Requires contact id, note.
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

Contact records change exactly as intended

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