Connectors

/

HubSpot

/

Change who is on a HubSpot list
Write

Add or remove named contacts on a HubSpot list

For marketing and sales teams who need to adjust a manual HubSpot list by email address, just by asking their AI assistant.

Try PopdockAI free
Get a live demo
Change who is on a HubSpot list
Remove sam@contoso.com and lee@northwindtraders.com from the HubSpot list Q3 Event Invitees.
One of the two contacts is on Q3 Event Invitees, so one change is needed. - List: Q3 Event Invitees, manual - Remove: Sam Patel, sam@contoso.com - Skipped: lee@northwindtraders.com is not on the list Shall I remove Sam Patel?
HubSpot
Sample figures. Your results come from your own account.
hubspot-get-lists
hubspot-get-contacts
hubspot-get-contact-list-membership
hubspot-add-list-members
hubspot-remove-list-members

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

Small HubSpot list edits still take a dozen lookups

Adding or removing a few named people on a HubSpot list means looking up each contact, opening the list and checking who is already there. It is easy to add someone twice, remove the wrong person, or edit a list HubSpot manages itself.

Without PopdockAI

  • Look up each email as a contact
  • Open the list and check who is already on it
  • Add or remove people one at a time
  • Find out later the list was managed by HubSpot

With PopdockAI

  • Lists HubSpot manages itself are refused
  • Each email is matched to a contact, and misses are listed
  • People already in the right state are dropped and named
  • You see the exact changes and confirm before anything is written

The prompt

Use this prompt

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

Prompt
**Objective:** `{operation}` (add or remove; default add) the contacts `{contact-emails}` on the manual list `{list-name}`.

**Step 1: Resolve the list**

Call `hubspot-get-lists` with `name.contains` = `{list-name}`. If none or several match, list them and stop. If its `processing-type` is not MANUAL, say HubSpot manages its members and stop.

**Step 2: Resolve the contacts**

For each address in `{contact-emails}` (comma-separated), call `hubspot-get-contacts` with `email` = it. Collect the record-ids. List any address that matched no contact.

**Step 3: Check current membership**

For each contact call `hubspot-get-contact-list-membership` with `contact-id` = its record-id and `list-id` = the list's ID. For add, drop contacts already on the list; for remove, drop contacts not on it. Say which were dropped.

**Step 4: Confirm**

Show the list name and ID, the operation, and the contacts it will change (name, email, record-id). Wait for an explicit yes.

**Step 5: Write**

* add: `hubspot-add-list-members` once with `list-id` and `record-ids` = the remaining record-ids, comma-separated
* remove: `hubspot-remove-list-members` once with the same

**Step 6: Report**

Report what changed and which addresses were skipped and why.

**Rules & Guidelines:**

* Only the one tool in Step 5 may write, once, after Step 4.
* Do NOT call any other write tool: no other hubspot-add, hubspot-update, hubspot-rename, hubspot-remove, hubspot-subscribe, hubspot-unsubscribe or hubspot-import tool.

**Validation:**

* If `{operation}` is not add or remove, ask which and stop.
* If no contacts remain after Step 3, say nothing needs to change and stop.

Who it's for

One answer, three teams that use it

Marketing coordinators

Update an invite list in one message

Add the late registrations to an event list without opening HubSpot or checking who is already on it.

Add priya@contoso.com and tom.reyes@fabrikam.com to the HubSpot list Customer Summit Invitees.

Sales reps

Take contacts off a list when asked

Remove people who should not get the next send, with a clear report of what changed and what was skipped.

Remove dana@northwindtraders.com from the HubSpot list Q4 Promo Recipients.

Marketing operations

Keep list membership tidy

Duplicates and no-op changes are dropped before writing, and managed lists are never touched.

Add these five emails to the Beta Testers list in HubSpot and tell me which ones were already on it.

How it works

What PopdockAI does when you ask

You name the list, the emails and whether to add or remove, and your AI assistant checks every contact and the current membership. The list changes only after you confirm.

01

Resolve

It finds the list and checks that it is a manual list.

Your AI tool

02

Match

It finds each email address as a HubSpot contact and lists any with no match.

hubspot-get-contacts

03

Check

It drops contacts already on the list for an add, or not on it for a remove.

hubspot-get-contact-list-membership

04

Confirm

You see the exact changes, say yes, and it updates the list and reports the result.

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-lists

Returns HubSpot lists (segments) of any object type, with size and processing type from the HubSpot connector. Filter by size, processing type, name, list id, object type.
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-contact-list-membership

Returns which contacts belong to which contact lists from the HubSpot connector. Filter by list name, contact id, contact email, list id.
run-action

hubspot-add-list-members

Adds records to a manual HubSpot list. Required: List ID, Record IDs. Writes to HubSpot.
run-action

hubspot-remove-list-members

Removes records from a manual HubSpot list. Required: List ID, Record IDs. Writes to HubSpot.
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

List changes on the right contacts, once

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