/
/
Build a HubSpot contact list by describing who belongs on it
For marketing and sales teams who want a targeted HubSpot list without setting up filters, just by asking their AI assistant.
On this page
Connector
Connect HubSpot, pick your AI tool and paste the prompt.
The problem
One-off HubSpot lists take filters, counts and clean up
Building a one-off HubSpot list means setting up filters, checking the count, creating the list and adding the contacts. Reuse a name already taken, or touch a list HubSpot manages itself, and you end up with a mess.
Without PopdockAI
- Set up contact filters field by field
- Check the count and scan the results
- Create the list and add the contacts
- Untangle name clashes with existing lists
With PopdockAI
- Your plain words become HubSpot contact filters
- Existing list names are checked and only manual lists are reused
- You see the filters, count and first 20 contacts first
- The list size is reported once it is built
The prompt
Use this prompt
Copy it into any AI tool connected to PopdockAI. Swap the values in braces for your own.
**Objective:** Create the manual contact list `{list-name}` containing the contacts that match `{criteria}`.
**Step 1: Check the name**
Call `hubspot-get-lists` with `name` = `{list-name}`. If a list with that name exists, show its ID, type and size, and ask whether to add to it instead (then skip Step 4 and use its `list-id`, but only if its `processing-type` is MANUAL).
**Step 2: Find the contacts**
Translate `{criteria}` into `hubspot-get-contacts` filters. Use only these: `lifecycle-stage`, `lead-status`, `company-name` / `company-name.contains`, `company-id`, `state-region`, `contact-owner`, `email.contains`, `create-date.from` / `create-date.to`. Set `max-records` = 500. If a criterion maps to none of these, say it cannot be filtered on and ask whether to continue without it.
**Step 3: Confirm**
Show the filters used, the number of contacts, and the first 20 (name, email, company, lifecycle stage). Wait for an explicit yes.
**Step 4: Create the list**
Call `hubspot-add-list` once with `name` = `{list-name}`, `object-type` = 0-1, `processing-type` = MANUAL. Keep the returned `id`.
**Step 5: Add members**
Call `hubspot-add-list-members` with `list-id` and `record-ids` = the contacts' record-ids, comma-separated, in batches of at most 100.
**Step 6: Verify and report**
Call `hubspot-get-lists` with `list-id` and report its size. Note that HubSpot can take a minute to update the size.
**Rules & Guidelines:**
* Only `hubspot-add-list` (once) and `hubspot-add-list-members` (once per batch) may write, after Step 3.
* 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.
* Never touch an existing list whose `processing-type` is not MANUAL; HubSpot manages its members.
**Validation:**
* If no contacts match, say so and stop before creating the list.
* If more than 500 match, tell the user the list holds only the first 500 and ask them to narrow the criteria.Who it's for
One answer, three teams that use it
Campaign managers
Build a send list by describing it
Get a list of the right contacts for a campaign without setting up filters, with a preview before it is created.
Make a HubSpot list called Ohio Customers with every contact in Ohio whose lifecycle stage is customer.
Sales reps
Gather the contacts at one account
Pull every open lead at a company into a list you can work through, in one request.
Create a HubSpot list called Contoso Open Leads with all contacts at Contoso whose lead status is Open.
Marketing operations
Avoid clashing or managed lists
Name clashes are caught and lists HubSpot manages are left alone, so one-off lists do not clutter or break anything.
Build a list named New Signups October with contacts created since October 1 and an email at fabrikam.com.
How it works
What PopdockAI does when you ask
You describe who belongs on the list and your AI assistant turns it into filters and a preview. The list is only created after you have checked the count and said yes.
01
Ask
You name the list and describe the contacts, such as lifecycle stage, region or company.
02
Search
It checks the list name and turns your criteria into HubSpot contact filters.
03
Confirm
You see the filters, the count and the first 20 contacts, and say yes.
04
Create
It creates the manual list, adds the contacts and reports the list size.
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.
hubspot-get-lists
hubspot-get-contacts
hubspot-add-list
hubspot-add-list-members
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.
The outcome
A targeted list built from plain language
Related use cases
More ways to put this data to work
Change who is on a HubSpot list
Ask your AI to add or remove people on a HubSpot list and it checks current membership, shows exactly who will change and writes only after you confirm.
Learn More
Add HubSpot list members to a Constant Contact list
Ask your AI to add HubSpot list members to a Constant Contact list and it finds who is missing, excludes anyone opted out, and adds people only after you confirm.
Learn More
Add HubSpot list members to a Mailchimp audience
Ask your AI to add HubSpot list members to a Mailchimp audience and it skips opt-outs and existing members, then adds the rest as pending after you confirm.
Learn More
Chase overdue HubSpot invoices
Ask your AI to list overdue HubSpot invoices and it groups them by customer with the total owed, oldest due date, contact email and any recent payments.
Learn More
Check a HubSpot contact's email consent
Ask your AI whether a HubSpot contact can receive marketing email and it checks subscriptions, lists and delivery history for a verdict with dated evidence.
Learn More
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.