Create HubSpot Deal
Specialized skill for creating deals in HubSpot CRM.
Pre-Flight Check
Before running, execute config check:
bash
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
- •
--name- Deal name (required)
Optional Parameters
- •
--amount- Deal value in dollars - •
--stage- Deal stage ID - •
--closedate- Expected close date (YYYY-MM-DD) - •
--pipeline- Pipeline ID (uses default if not specified)
Examples
Minimal (name only):
bash
python 00-system/skills/hubspot/hubspot-master/scripts/create_deal.py \ --name "New Enterprise Deal" \ --json
Full deal:
bash
python 00-system/skills/hubspot/hubspot-master/scripts/create_deal.py \ --name "Acme Corp - Enterprise" \ --amount 50000 \ --stage "qualifiedtobuy" \ --closedate "2025-03-15" \ --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 |
Output Format
json
{
"id": "5840795376",
"properties": {
"dealname": "Acme Corp - Enterprise",
"amount": "50000",
"dealstage": "qualifiedtobuy",
"closedate": "2025-03-15T00:00:00Z",
"createdate": "2025-12-13T10:00:00Z"
}
}
Display Format
code
✅ Deal created! ID: 5840795376 Name: Acme Corp - Enterprise Amount: $50,000 Stage: Qualified to Buy Close Date: 2025-03-15
Error Handling
| Error | Solution |
|---|---|
| 401 | Invalid token - re-run setup |
| 403 | Missing crm.objects.deals.write scope |
| 400 | Invalid stage ID - check stage list |
| 429 | Rate limited - wait and retry |
Related Skills
- •
hubspot-list-deals- List all deals - •
hubspot-update-deal- Update deal stage/amount - •
hubspot-search-deals- Find existing deals - •
hubspot-get-associations- Link contacts to deal