Update HubSpot Deal
Specialized skill for updating deals in HubSpot CRM.
Pre-Flight Check
Before running, execute config check:
python 00-system/skills/hubspot/hubspot-master/scripts/check_hubspot_config.py --json
If ai_action is not proceed_with_operation , follow hubspot-connect setup guide.
Usage
Required Parameters
- --id
- Deal ID (required)
Optional Parameters (at least one required)
-
--name
-
New deal name
-
--amount
-
New deal value
-
--stage
-
New deal stage
-
--closedate
-
New close date (YYYY-MM-DD)
Examples
Update stage (move deal):
python 00-system/skills/hubspot/hubspot-master/scripts/update_deal.py
--id 5840795376
--stage "closedwon"
--json
Update amount:
python 00-system/skills/hubspot/hubspot-master/scripts/update_deal.py
--id 5840795376
--amount 75000
--json
Close deal as won:
python 00-system/skills/hubspot/hubspot-master/scripts/update_deal.py
--id 5840795376
--stage "closedwon"
--closedate "2025-12-13"
--json
Common Deal Stages
Stage ID Name
appointmentscheduled Appointment Scheduled
qualifiedtobuy Qualified to Buy
presentationscheduled Presentation Scheduled
decisionmakerboughtin Decision Maker Bought In
contractsent Contract Sent
closedwon Closed Won
closedlost Closed Lost
Finding Deal ID
If user says "close the Acme deal", first search:
python 00-system/skills/hubspot/hubspot-master/scripts/search_deals.py --name "Acme" --json
Then use the returned ID for the update.
Output Format
{ "id": "5840795376", "properties": { "dealname": "Acme Corp - Enterprise", "amount": "75000", "dealstage": "closedwon", "hs_lastmodifieddate": "2025-12-13T10:30:00Z" } }
Display Format
✅ Deal updated! ID: 5840795376 Name: Acme Corp - Enterprise Updated fields: - stage: Closed Won - amount: $75,000
Error Handling
Error Solution
401 Invalid token - re-run setup
403 Missing crm.objects.deals.write scope
404 Deal not found - check ID
400 Invalid stage ID
429 Rate limited - wait and retry
Related Skills
-
hubspot-search-deals
-
Find deal ID
-
hubspot-list-deals
-
List all deals
-
hubspot-create-deal
-
Create new deal