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