hubspot-create-deal

Creates new deals in HubSpot CRM with name, amount, stage, and close date parameters.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually creating deals in the HubSpot web interface is slow and repetitive, especially when logging multiple opportunities. This Skill lets you create HubSpot deals directly from your AI assistant with a single command. ## Core Features & Use Cases - Deal Creation via CLI: Create deals with a required name plus optional amount, stage, pipeline, and close date. - Pre-Flight Config Check: Validates HubSpot credentials before running, preventing failed API calls. - Structured JSON Output: Returns the created deal's ID and properties for use in downstream workflows. - Use Case: After a sales call, tell your assistant to create a deal for "Acme Corp - Enterprise" worth $50,000 at the qualified-to-buy stage, and it is logged in HubSpot immediately. ## Quick Start Ask your assistant to create a HubSpot deal named Acme Corp Enterprise for 50000 dollars closing on 2025-03-15.

Frequently Asked Questions about hubspot-create-deal

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

FAQPage Schema
How do I create a deal in HubSpot from the command line?

Run the create_deal.py script with a --name parameter and optional --amount, --stage, --closedate, and --pipeline flags. The script calls the HubSpot API and returns the created deal as JSON.

What HubSpot deal stages can I use when creating a deal?

Standard stage IDs include appointmentscheduled, qualifiedtobuy, presentationscheduled, decisionmakerboughtin, contractsent, closedwon, and closedlost. Pass the stage ID via the --stage parameter.

What permissions does the HubSpot API token need to create deals?

The token requires the crm.objects.deals.write scope. A 403 error indicates a missing scope, while a 401 error means the token is invalid and setup must be re-run.

Why does HubSpot deal creation return a 400 error?

A 400 error typically means an invalid stage ID was provided. Check the stage list in the documentation and verify the --stage value matches a valid pipeline stage ID.

Can I create a HubSpot deal with only a name?

Yes, --name is the only required parameter. Amount, stage, close date, and pipeline are optional, and the default pipeline is used when --pipeline is omitted.