Create HubSpot Deal
Specialized skill for creating 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
--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):
python 00-system/skills/hubspot/hubspot-master/scripts/create_deal.py \
--name "New Enterprise Deal" \
--json
Full deal:
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
{
"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
ā
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