/
/
Move HubSpot deals with the reason on record
For sales reps who want deal stage changes made correctly and explained, by asking their AI assistant.
On this page
Connector
Connect HubSpot, pick your AI tool and paste the prompt.
The problem
Deal moves happen with no reason on record
Moving a HubSpot deal looks simple, but each pipeline has its own stages, a wrong stage breaks reporting, and the reason is rarely written down. Backwards moves and closed won with no amount slip through.
Without PopdockAI
- Find the deal and its pipeline
- Pick the stage from the right pipeline
- Forget to note why it moved
- Miss a backwards move or a missing amount
With PopdockAI
- The stage is matched within the deal's own pipeline
- Backwards moves, no change and no amount wins are warned
- You see the change and the note before anything is saved
- Only the stage and close date change, and the stage is read back
The prompt
Use this prompt
Copy it into any AI tool connected to PopdockAI. Swap the values in braces for your own.
**Objective:** Move the deal `{deal-name}` to the stage `{target-stage}`, record `{reason}` as a note, and set close date `{close-date}` when given.
**Step 1: Find the deal**
Call `hubspot-get-deals` with `deal-name.contains` = `{deal-name}`. If none or several match, list them and stop. Note the current stage, pipeline, amount and close date.
**Step 2: Resolve the stage**
Call `hubspot-get-deal-pipelines` with `label` = the deal's `pipeline-name` to get its pipeline-id, then `hubspot-get-deal-pipeline-stages` with that pipeline-id. Find the stage whose `label` matches `{target-stage}` (exact first, then contains). If none matches, list the pipeline's stages and stop. Do not pick a stage from another pipeline.
**Step 3: Sanity checks**
* If the deal is already in that stage, say so and stop.
* If the target is Closed won and the deal has no amount, warn the user.
* If the move goes backwards in `display-order`, point that out.
**Step 4: Confirm**
Show: deal, current stage to target stage, close date change if any, and the note text. Wait for an explicit yes.
**Step 5: Write**
Call `hubspot-update-deal` once with `id` = the deal's record-id, `deal-stage` = the stage-id, and `close-date` only when `{close-date}` is given. Pass no other fields. Then call `hubspot-add-deal-note` once with `deal-id` = the record-id and `note` = "Moved to <stage label>: {reason}".
**Step 6: Verify**
Call `hubspot-get-deals` with `record-id` = the deal's id and confirm the stage reads back as the target.
**Rules & Guidelines:**
* Only `hubspot-update-deal` and `hubspot-add-deal-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-contact`, `hubspot-update-company`, `hubspot-update-ticket`, `hubspot-add-contact-note`, `hubspot-add-company-note`, `hubspot-add-ticket-note`.
* Never pass an empty value for a field you are not changing; an empty value clears it.
**Validation:**
* If the update fails, report the error and do not add the note.Who it's for
One answer, three teams that use it
Account executives
Move deals as soon as things change
Update the stage in one message with the reason noted, so the pipeline keeps up with the deal.
Move the Fabrikam Expansion deal to Negotiation, they asked for revised terms today.
Sales managers
Know why each deal moved
Every stage change carries a note with the reason, so reviews start from facts.
Move the Northwind Traders deal back to Discovery because the champion left, and note why.
Revenue operations
Stop bad wins reaching the report
Closing won with no amount gets a warning, so reports are not skewed by empty deals.
Mark the Contoso renewal deal Closed won with a close date of today, the order form was signed.
How it works
What PopdockAI does when you ask
You name the deal, the stage and the reason, and your AI assistant checks the move makes sense. Nothing is saved until you have seen the change and the note and said yes.
01
Ask
You name the deal, the target stage, the reason and optionally a close date.
02
Check
It matches the stage in the deal's pipeline and warns on backwards or no-amount moves.
03
Confirm
You see the change and the note, and say yes.
04
Update
It changes only the stage and close date, adds the note and reads the stage back.
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-deals
hubspot-get-deal-pipelines
hubspot-get-deal-pipeline-stages
hubspot-update-deal
hubspot-add-deal-note
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 pipeline you can trust, with reasons on record
Related use cases
More ways to put this data to work
HubSpot deal pipeline review
Ask your AI for a HubSpot pipeline review and it totals value and weighted value per stage, lists deals closing soon and overdue, and notes where value is stuck.
Learn More
Create a HubSpot deal for a company
Ask your AI to create a HubSpot deal and it matches the company, checks for a similar open deal, resolves the pipeline and first stage, and saves after you confirm.
Learn More
Log a HubSpot meeting follow-up
Ask your AI to log a HubSpot meeting follow-up and it notes the outcome on the deal, contact and company and moves the deal stage after you confirm.
Learn More
HubSpot closed won deals without a Stripe subscription
Ask your AI to check recent HubSpot wins against Stripe and it lists deals with no customer, no live subscription or billing more than 10 percent off the deal.
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
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.