hubspot-list-calls_skill

Overview

This skill lists call engagements from a HubSpot CRM account and returns the logged call records in a structured format. It provides a paginated JSON output plus a readable display summary showing title, direction, duration, status, date, notes, and ID. Use it to quickly review recent call history or to integrate call data into workflows.

How this skill works

The script queries HubSpot's calls endpoint after a pre-flight config check to verify authentication and scopes. It supports limit and pagination parameters and returns results with properties like title, body, direction, duration, status, and timestamp. Errors such as invalid token, missing scope, or rate limits are surfaced with recommended remedial steps.

When to use it

• Review recent call activity for a contact or account
• Export or sync call records to another system
• Audit call outcomes and durations for reporting
• Investigate specific call IDs or timestamps
• Programmatically paginate through historical call logs

Best practices

• Run the config check before listing to confirm authentication and scopes
• Start with a small --limit for quick checks, increase when needed
• Use --after cursor for reliable pagination in large datasets
• Map hs_call_direction and hs_call_duration to user-friendly values in your UI
• Handle 401/403/429 responses with retries and clear user messages

Example use cases

• Quickly show the last 10 calls with default command for a sales review
• Fetch 25 recent calls for a weekly performance report using --limit 25
• Paginate through older calls programmatically with --after cursor values
• Integrate results into a dashboard that displays call duration and status trends
• Look up a specific call by ID after locating it in the list output