hubspot-update-deal

Update existing HubSpot CRM deal properties including stage, amount, and close date.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-update-deal-fahadimdad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hubspot-update-deal
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/hubspot/hubspot-update-deal
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-update-deal-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually editing deals in the HubSpot web interface is slow when you need to move deals through pipeline stages, adjust amounts, or close deals quickly. This Skill lets you update any deal property directly from your AI assistant using the HubSpot API. ## Core Features & Use Cases - Deal Property Updates: Modify deal name, amount, stage, and close date on any existing deal by ID. - Pipeline Stage Management: Move deals through standard stages like qualifiedtobuy, contractsent, closedwon, or closedlost. - Deal Lookup Integration: Search for deals by name first when you only know the company name, then apply the update. - Use Case: A sales rep finishes a call and says "close the Acme deal as won" — the Skill searches for the deal, retrieves its ID, and updates the stage to closedwon with today's close date. ## Quick Start Ask the AI to update a HubSpot deal, for example: "Move deal 5840795376 to closed won with an amount of 75000."

Frequently Asked Questions about hubspot-update-deal

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update a deal in HubSpot via API?

Run the update_deal.py script with the deal ID and at least one property flag such as --stage, --amount, --name, or --closedate. The script calls the HubSpot API and returns the updated deal properties as JSON.

How do I find a HubSpot deal ID if I only know the company name?

Use the search_deals.py script with the --name flag to search deals by keyword, for example --name "Acme". The search returns matching deals with their IDs, which you then pass to the update command.

What HubSpot deal stages can I set when updating a deal?

Standard stage IDs include appointmentscheduled, qualifiedtobuy, presentationscheduled, decisionmakerboughtin, contractsent, closedwon, and closedlost. Custom pipelines may use different stage IDs defined in your HubSpot portal.

Why does HubSpot deal update return a 403 error?

A 403 error means your API token lacks the crm.objects.deals.write scope. Re-run the HubSpot setup flow and ensure the private app token includes write permissions for deals.

Can I update multiple deal properties in one HubSpot API call?

Yes, pass multiple flags in a single command, such as --stage closedwon together with --amount 75000 and --closedate 2025-12-13. All provided properties are updated in one request.