hubspot-update-deal

Update HubSpot CRM deal records with targeted field changes.

2|1|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/abdullahbeam/nexus-design-abdullah --skill hubspot-update-deal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hubspot-update-deal
Source: https://github.com/abdullahbeam/nexus-design-abdullah/tree/main/00-system/skills/hubspot/hubspot-update-deal
Command: npx skills add https://github.com/abdullahbeam/nexus-design-abdullah --skill hubspot-update-deal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually updating deal details in HubSpot CRM is slow, error-prone, and requires navigating the web interface every time you need to adjust a deal's stage, value, or close date, taking time away from core sales tasks.

Core Features & Use Cases

  • Targeted Deal Field Updates: Modify deal name, monetary amount, sales stage, and close date individually or in combination without leaving your workflow.
  • Pre-Flight Configuration Validation: Automatically checks your HubSpot API connection is properly configured before running updates to prevent failed operations.
  • Built-In Reference & Troubleshooting: Includes a list of standard HubSpot deal stage IDs and clear guidance for resolving common API errors like invalid tokens or missing permissions.
  • Use Case: A sales representative who just secured a new client can immediately update the deal stage to "Closed Won", set the close date to the contract signing date, and adjust the deal amount to match the final agreed value in one step, no manual CRM navigation required.

Quick Start

Use the hubspot-update-deal skill to update the stage of deal ID 5840795376 to closedwon and set its close date to 2025-12-13.

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 HubSpot deal stages without logging into the CRM?

To update HubSpot deal stages without manual CRM navigation, you need a valid HubSpot API connection with the crm.objects.deals.write scope and an existing deal ID. The skill validates this connection pre-flight before applying targeted field updates.

Can I update a HubSpot deal amount and close date in one step?

Yes, you can update a HubSpot deal's monetary amount, sales stage, and close date individually or in combination in one step. This eliminates manual CRM work by applying targeted field updates to a valid existing deal record.

What HubSpot API permissions do I need to automate deal updates?

Automating HubSpot deal updates requires the crm.objects.deals.write API scope and a valid existing deal ID. The process includes built-in troubleshooting guidance for resolving common API errors like invalid tokens or missing permissions.

Why do my automated HubSpot CRM deal updates fail with invalid token errors?

Automated HubSpot CRM deal updates fail with invalid token errors when the API connection lacks the crm.objects.deals.write scope. The skill includes built-in troubleshooting guidance for resolving invalid tokens and missing permissions during pre-flight validation.

What is the best way to move a deal to closed won in HubSpot sales operations?

The best way to move a deal to closed won in HubSpot sales operations is using an automated API skill to update the deal stage, set the close date, and adjust the final contract value simultaneously. This eliminates slow, error-prone manual web interface navigation.

Do I need an existing deal ID to update a HubSpot CRM record?

Yes, you need a valid existing deal ID to execute targeted field updates on HubSpot CRM records. The skill applies changes to pipeline stages, monetary amounts, and close dates for existing deals rather than creating new records.