Create HubSpot Deal Skill

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

Agent Skills: Create HubSpot Deal

Install this agent skill to your local

Skill Files