| name | hubspot-list-calls |
| description | List call engagements from HubSpot CRM. Load when user says 'list calls', 'show calls', 'call history', 'hubspot calls'. Returns logged call records. |
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 callhubspot-get-associations- Get call's linked contacts