List HubSpot Deals Skill

List HubSpot Deals

Specialized skill for listing deals from 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

Basic List (default 10 deals)

python 00-system/skills/hubspot/hubspot-master/scripts/list_deals.py --json

With Limit

python 00-system/skills/hubspot/hubspot-master/scripts/list_deals.py --limit 25 --json

With Pagination

python 00-system/skills/hubspot/hubspot-master/scripts/list_deals.py --after "cursor_value" --json

Output Format

{
  "results": [
    {
      "id": "5840795376",
      "properties": {
        "dealname": "Enterprise Deal",
        "amount": "50000",
        "dealstage": "qualifiedtobuy",
        "pipeline": "default",
        "closedate": "2025-03-15T00:00:00Z"
      },
      "url": "https://app.hubspot.com/contacts/.../record/0-3/5840795376"
    }
  ],
  "paging": {
    "next": {
      "after": "cursor_for_next_page"
    }
  }
}

Display Format

Found {count} deals:

1. Enterprise Deal
   Amount: $50,000
   Stage: Qualified to Buy
   Close Date: 2025-03-15
   ID: 5840795376

2. Startup Package
   Amount: $5,000
   Stage: Proposal Sent
   ...

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 |

Error Handling

| Error | Solution | |-------|----------| | 401 | Invalid token - re-run setup | | 403 | Missing crm.objects.deals.read scope | | 429 | Rate limited - wait and retry |

Related Skills

hubspot-create-deal - Create new deal
hubspot-search-deals - Search by name/amount
hubspot-update-deal - Update deal stage
hubspot-get-associations - Get deal contacts

Agent Skills: List HubSpot Deals

Install this agent skill to your local

Skill Files