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:
-
Enterprise Deal Amount: $50,000 Stage: Qualified to Buy Close Date: 2025-03-15 ID: 5840795376
-
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