hubspot-list-calls

Lists call engagement records from HubSpot CRM with pagination support.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-list-calls-fahadimdad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hubspot-list-calls
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/hubspot/hubspot-list-calls
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-list-calls-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Retrieving logged call activity from HubSpot CRM normally requires navigating the UI or writing raw API requests. This Skill fetches call engagement records directly from the command line and returns them as structured JSON. ## Core Features & Use Cases - Call History Retrieval: Lists logged calls with title, direction, duration, status, timestamp, and notes. - Pagination & Limits: Control result counts with a limit flag and page through large call histories using cursor-based pagination. - Pre-Flight Config Check: Verifies HubSpot credentials and required scopes before executing the request. - Use Case: A sales manager asks for the last 25 calls logged this week to review team outreach activity, and receives a formatted list with direction, duration, and notes for each call. ## Quick Start Ask the assistant to list recent HubSpot calls, optionally specifying how many records to return.

Frequently Asked Questions about hubspot-list-calls

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list call history from HubSpot CRM?

Run the list_calls.py script with the --json flag to retrieve logged call engagements from HubSpot. Use --limit to control how many records are returned, with a default of 10 calls.

How to paginate through HubSpot call records?

Pass the cursor value from the paging.next.after field of a previous response using the --after flag. HubSpot returns this cursor whenever more results exist beyond the current page.

What HubSpot API scope is needed to read calls?

Reading call engagements requires the crm.objects.calls.read scope on your HubSpot access token. A 403 error indicates this scope is missing and the token must be regenerated with the correct permissions.

Why does HubSpot return a 401 error when listing calls?

A 401 error means the access token is invalid or expired. Re-run the HubSpot setup flow to generate a new token, then retry the list operation.

What data does a HubSpot call engagement include?

Each call record includes the title, body notes, direction (INBOUND or OUTBOUND), duration in milliseconds, status such as COMPLETED, and the timestamp of the call.