skills.rest
FahadImdad
FahadImdadCOMMUNITY
Explore all skills by this author →
GitHub

hubspot-list-emails

List email engagement records from HubSpot CRM with pagination support.

Updated Jan 22, 2026
Search Tags:#sales#email#crm#list#hubspot#pagination#engagements
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-list-emails-fahadimdad
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hubspot-list-emails
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/hubspot/hubspot-list-emails
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-list-emails-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Retrieving logged email activity from HubSpot CRM normally requires manual navigation through the CRM interface or writing custom API calls. This Skill returns email engagement records directly through a script, including subject, direction, status, and timestamps. ## Core Features & Use Cases - Email Listing: Fetch logged email engagements from HubSpot CRM with a configurable result limit. - Pagination Support: Page through large email histories using cursor-based pagination tokens. - Structured Output: Returns JSON with email properties such as subject, direction (sent/received/forwarded), status, and timestamp. - Use Case: A sales rep asks for recent email history before a client call and receives a formatted list of the last 25 sent and received emails with dates and previews. ## Quick Start Ask the AI to list your recent HubSpot emails, optionally specifying how many records to return.

Frequently Asked Questions about hubspot-list-emails

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

FAQPage Schema
How do I list emails from HubSpot CRM?▼

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

How to paginate through HubSpot email records?▼

Pass the cursor value from the paging.next.after field of a previous response using the --after flag. The HubSpot API returns this cursor whenever additional pages of results exist.

What HubSpot API scope is needed to read emails?▼

Reading email engagements requires the crm.objects.emails.read scope on your HubSpot private app token. A 403 error indicates this scope is missing and the token must be reconfigured.

Why does HubSpot return a 401 or 429 error when listing emails?▼

A 401 error means the access token is invalid and setup must be re-run. A 429 error indicates rate limiting, which resolves by waiting and retrying the request.

What do HubSpot email direction values mean?▼

EMAIL indicates an outbound sent message, INCOMING_EMAIL indicates a received message, and FORWARDED_EMAIL indicates a forwarded message. These values appear in the hs_email_direction property of each record.

Related Skills

Explore More Marketing & Sales Skills→
beam-ai-teambeam-ai-team

hubspot-connect

Automate HubSpot CRM operations for contacts, companies, deals, and engagements.

Official
Advanced
paywherebpaywhereb

crm-maintenance

Create and update HubSpot contacts, deals, and activities from email and calendar context.

Official
Advanced
TomGranotTomGranot
58

enrich-industry

Copy industry values from associated company records to HubSpot contacts.

Community
Advanced
abdullahbeamabdullahbeam
2

hubspot-log-email

Log email engagement records to HubSpot CRM with metadata.

Community
Intermediate