abdullahbeam/hubspot-list-calls

List HubSpot Calls

Specialized skill for listing call engagements 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 calls)

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

With Limit

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

With Pagination

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

---

Output Format

{
  "results": [
    {
      "id": "14772074448",
      "properties": {
        "hs_call_title": "Discovery Call",
        "hs_call_body": "Discussed requirements and timeline...",
        "hs_call_direction": "OUTBOUND",
        "hs_call_duration": "1800000",
        "hs_call_status": "COMPLETED",
        "hs_timestamp": "2025-12-13T10:00:00Z"
      }
    }
  ],
  "paging": {
    "next": {
      "after": "cursor_for_next_page"
    }
  }
}

---

Display Format

Found {count} calls:

1. Discovery Call
   Direction: Outbound
   Duration: 30 minutes
   Status: Completed
   Date: 2025-12-13 10:00
   Notes: Discussed requirements and timeline...
   ID: 14772074448

2. Follow-up Call
   Direction: Inbound
   ...

---

Call Direction Values

| Value | Meaning | |-------|---------| | OUTBOUND | Made call | | INBOUND | Received call |

---

Error Handling

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

---

Related Skills

• hubspot-log-call - Log new call
• hubspot-get-associations - Get call's linked contacts